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 コントロールの内容変更時にセルのサイズを自動的に変更する

DataGridViewAutoSizeRowsMode 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

行の高さを調節する方法を指定するための値を定義します。

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

Visual Basic (宣言)

Public Enumeration DataGridViewAutoSizeRowsMode

Visual Basic (使用法)

Dim instance As DataGridViewAutoSizeRowsMode

C#

public enum DataGridViewAutoSizeRowsMode

C++

public enum class DataGridViewAutoSizeRowsMode

J#

public enum DataGridViewAutoSizeRowsMode

JScript

public enum DataGridViewAutoSizeRowsMode

メンバ

	メンバ名	説明
	AllCells	行の高さが、ヘッダー セルを含む行内のすべてのセルの内容に合わせて調節されます。
	AllCellsExceptHeaders	行の高さが、ヘッダー セルを除く行内のすべてのセルの内容に合わせて調節されます。
	AllHeaders	行の高さが、行ヘッダーの内容に合わせて調節されます。
	DisplayedCells	行の高さが、現在画面上に表示されている、ヘッダー セルを含む行内のすべてのセルの内容に合わせて調節されます。
	DisplayedCellsExceptHeaders	行の高さが、現在画面上に表示されている、ヘッダー セルを除く行内のすべてのセルの内容に合わせて調節されます。
	DisplayedHeaders	行の高さが、現在画面上に表示されている行ヘッダーの内容に合わせて調節されます。
	None	行の高さは自動的に調節されません。

解説

DataGridView コントロールでは、各行の推奨される高さに基づいて行のサイズを変更できます。推奨される行の高さとは、その行に含まれるセル値のうち最もサイズの大きいものを表示するために必要な最小限の高さです。各種のサイズ モードによって、新しい高さの計算に使用するセル (ヘッダー セルとそれ以外のセルのいずれか) や、すべての行をサイズ変更するか、または現在表示されている行のみサイズ変更するかを指定できます。多くの行のデータを処理することによるパフォーマンスの低下を防ぐには、行のサブセットのみサイズ変更すると便利です。

内容に合わせた自動サイズ変更機能を使用すると、ユーザーがマウスで行の高さを調節できなくなります。

この列挙体は、DataGridView コントロールの AutoSizeRowsMode プロパティと AutoResizeRows メソッドによって使用されます。

サイズ指定モードの詳細については、「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 CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.AutoSizeRowsMode プロパティ
System.Windows.Forms.DataGridView.AutoResizeRows
その他の技術情報
Windows フォーム DataGridView コントロールのサイズ変更オプション
方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する