DataGridView.AutoSizeRowsMode プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridView.AutoSizeRowsMode プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

行の高さを決定する方法を示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property AutoSizeRowsMode As
 DataGridViewAutoSizeRowsMode

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As DataGridViewAutoSizeRowsMode

value = instance.AutoSizeRowsMode

instance.AutoSizeRowsMode = value

C#

public DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get;
 set; }

C++

public:
property DataGridViewAutoSizeRowsMode AutoSizeRowsMode {
    DataGridViewAutoSizeRowsMode get ();
    void set (DataGridViewAutoSizeRowsMode
 value);
}

J#

/** @property */
public DataGridViewAutoSizeRowsMode get_AutoSizeRowsMode ()

/** @property */
public void set_AutoSizeRowsMode (DataGridViewAutoSizeRowsMode
 value)

JScript

public function get AutoSizeRowsMode
 () : DataGridViewAutoSizeRowsMode

public function set AutoSizeRowsMode
 (value : DataGridViewAutoSizeRowsMode)

プロパティ値
サイズ変更モードを示す DataGridViewAutoSizeRowsMode 値。既定値は None です。

例外

例外の種類	条件
InvalidEnumArgumentException	このプロパティの設定時に指定された値が、有効な DataGridViewAutoSizeRowsMode 値ではありません。
InvalidOperationException	このプロパティの設定時に指定された値は AllHeaders または DisplayedHeaders で、行ヘッダーは非表示です。

解説

このプロパティを使用すると、内容が変わったときに、それに合わせて行の高さが自動的に調整されるようにコントロールを設定できます。WrapMode が有効にされている場合、列幅が変化すると常に行の高さも調整されます。一部のサイズ変更モードでは、パフォーマンスを向上させるために、サイズ調整を現在表示されている行だけに制限できます。

Visible プロパティ値が true の行だけが自動的にサイズ変更され、行の表示状態を変更してもサイズは変更されません。また、行が自動的にサイズ変更されるように設定されている場合、ユーザーはマウスを使用して行の高さを調整することはできません。

行の高さをプログラムによって調整するには、AutoResizeRow メソッドまたは AutoResizeRows メソッドを使用するか、行の Height プロパティを設定します。

行のサイズが変更されたときに、セルの内容が複数の行に折り返されるようにするには、セルに対して有効なセル スタイルの WrapMode プロパティ値を True に設定する必要があります。

内容に基づく自動サイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ変更オプション」を参照してください。

使用例

行ヘッダーおよびすべての列の内容に基づいて、行のサイズが自動的に変更されるように設定する方法を示すコード例を次に示します。次のコード例は「方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する」の例の一部です。

Visual Basic

Private Sub AutoSizeRowsMode(ByVal
 sender As Object, _
    ByVal e As System.EventArgs) Handles
 Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

C#

private void AutoSizeRowsMode(Object sender,
 EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
DataGridViewAutoSizeRowsMode
その他の技術情報
DataGridView コントロール (Windows フォーム)
方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する