DataGridView.AutoSizeColumnsModeとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DataGridView.AutoSizeColumnsMode プロパティ

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

列の幅を決定する方法を示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property AutoSizeColumnsMode As
 DataGridViewAutoSizeColumnsMode

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As DataGridViewAutoSizeColumnsMode

value = instance.AutoSizeColumnsMode

instance.AutoSizeColumnsMode = value

public DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get;
 set; }

C++

public:
property DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode {
    DataGridViewAutoSizeColumnsMode get ();
    void set (DataGridViewAutoSizeColumnsMode
 value);
}

/** @property */
public DataGridViewAutoSizeColumnsMode get_AutoSizeColumnsMode
 ()

/** @property */
public void set_AutoSizeColumnsMode (DataGridViewAutoSizeColumnsMode
 value)

JScript

public function get AutoSizeColumnsMode
 () : DataGridViewAutoSizeColumnsMode

public function set AutoSizeColumnsMode
 (value : DataGridViewAutoSizeColumnsMode)

プロパティ値
DataGridViewAutoSizeColumnsMode 値。既定値は None です。

例外

例外の種類	条件
InvalidEnumArgumentException	このプロパティの設定時に指定された値が、有効な DataGridViewAutoSizeColumnsMode 値ではありません。
InvalidOperationException	このプロパティの設定時に指定された値は ColumnHeader で、列ヘッダーは非表示であり、少なくとも 1 つの可視列に NotSet の AutoSizeMode プロパティ値が設定されています。またはこのプロパティの設定時に指定された値は Fill で、AutoSizeMode プロパティ値が NotSet の少なくとも 1 つの可視列が固定されています。

例外の種類

条件

InvalidEnumArgumentException

このプロパティの設定時に指定された値が、有効な DataGridViewAutoSizeColumnsMode 値ではありません。

InvalidOperationException

このプロパティの設定時に指定された値は ColumnHeader で、列ヘッダーは非表示であり、少なくとも 1 つの可視列に NotSet の AutoSizeMode プロパティ値が設定されています。

または

このプロパティの設定時に指定された値は Fill で、AutoSizeMode プロパティ値が NotSet の少なくとも 1 つの可視列が固定されています。

解説

このプロパティを使用すると、コントロールを塗りつぶすか、セルの内容に合わせて列の幅が自動的に調整されるようにコントロールを設定できます。コントロールの幅が変更されるたびに、サイズ調整が塗りつぶしモードで発生します。内容に基づくサイズ変更モードでは、セルの内容が変更されるか、WrapMode が有効な場合は行の高さが変更されるたびに、サイズ調整が発生します。内容に基づくサイズ変更モードによっては、パフォーマンスを向上させるために、サイズ調整を現在表示されている行だけに制限できます。

個別の列のサイズ変更モードを変更するには、AutoSizeMode プロパティを設定します。このプロパティの既定値は NotSet です。これは、列がコントロールから動作と InheritedAutoSizeMode プロパティ値を継承することを示します。

塗りつぶしモードの列は、FillWeight プロパティ値の指定に応じて、使用可能なコントロールの幅を分割します。塗りつぶしモードに使用できる幅は、コントロールのクライアント領域の幅からその他のすべての列の幅を減算して決定されます。この幅が塗りつぶしモードのすべての列の MinimumWidth を合わせた値よりも小さい場合は、水平スクロールバーが表示され、塗りつぶしモードのすべての列が最小幅で表示されて、ユーザーによるサイズ変更が無効になります。列の塗りつぶしモードの詳細については、「Windows フォーム DataGridView コントロールの列フィルモード」を参照してください。

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

列の幅をプログラムによって調整するには、AutoResizeColumn メソッドまたは AutoResizeColumns メソッドを使用するか、列の Width プロパティを設定します。

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

使用例

2 つの DataGridView コントロールが親子リレーションシップの 2 つのテーブルからデータを表示するマスター/詳細シナリオでこのプロパティを使用するコード例を次に示します。この例では、マスターコントロールの列サイズ変更モードは None で、列の幅は、読み込まれる値に合わせてプログラムによって初期化されます。詳細コントロールは、自動列サイズ変更モードに設定されているため、値が変更されるたびに列が自動的に調整されます (ユーザーが親テーブルの現在の行を変更した場合など)。次の例は「方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター/詳細形式のフォームを作成する」で取り上げている例の一部です。

Visual Basic

Private Sub Form1_Load(ByVal
 sender As Object, ByVal
 e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded
 data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

private void Form1_Load(object sender, System.EventArgs
 e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded
 data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
DataGridViewAutoSizeColumnsMode
DataGridViewColumn.FillWeight
その他の技術情報
DataGridView コントロール (Windows フォーム)

DataGridViewAutoSizeColumnsMode 列挙体

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

列幅を調整する方法を指定するための値を定義します。

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

Visual Basic (宣言)

Public Enumeration DataGridViewAutoSizeColumnsMode

Visual Basic (使用法)

Dim instance As DataGridViewAutoSizeColumnsMode

public enum DataGridViewAutoSizeColumnsMode

C++

public enum class DataGridViewAutoSizeColumnsMode

public enum DataGridViewAutoSizeColumnsMode

JScript

public enum DataGridViewAutoSizeColumnsMode

メンバ

	メンバ名	説明
	AllCells	列幅は、ヘッダーセルを含む列内のすべてのセルの内容に合わせて調整されます。
	AllCellsExceptHeader	列幅は、ヘッダーセルを除く列内のすべてのセルの内容に合わせて調整されます。
	ColumnHeader	列幅は、列ヘッダーセルの内容に合わせて調整されます。
	DisplayedCells	列幅は、ヘッダーセルを含む列内のすべてのセルのうち、現在画面に表示されている行に含まれるセルの内容に合わせて調整されます。
	DisplayedCellsExceptHeader	列幅は、ヘッダーセルを除く列内のすべてのセルのうち、現在画面に表示されている行に含まれるセルの内容に合わせて調整されます。
	Fill	すべての列がコントロールの表示領域の幅いっぱいに表示されるよう、列幅が調整されます。水平スクロールは、列幅を DataGridViewColumn.MinimumWidth プロパティの値より大きくする場合にのみ必要です。相対的な列幅は、相対的な DataGridViewColumn.FillWeight プロパティの値によって決定されます。
	None	列幅は自動的に調整されません。

解説

DataGridView コントロールは列のサイズを変更して、コントロールの使用可能な水平幅を埋めるか、すべてのセルまたは指定されたセルのすべての内容が表示されるようにします。

Fill モードでは、コントロール内のすべての可視列が使用可能な表示領域の水平幅全体を埋めるように、そのモードのすべての列のサイズを変更することで、列の推奨幅が決定されます。その他のモードでは、推奨される列幅は、現在表示されている行のセルのサブセットなど、すべてのセルまたはその列のセルのサブセットから最大のセル値を表示するために必要な最小幅になります。多数のデータ行を処理することによるパフォーマンスの低下を防ぐには、セルのサブセットを使用して新しい幅を決定すると便利です。

内容に基づく自動サイズ変更機能を使用すると、ユーザーがマウスで列幅を調整できなくなります。ただし、塗りつぶしモードでは、ユーザーによるサイズ変更が有効になります。

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

サイズ変更モードの詳細については、「Windows フォーム DataGridView コントロールのサイズ変更オプション」を参照してください。特に列の塗りつぶしモードの詳細については、「Windows フォーム DataGridView コントロールの列フィルモード」を参照してください。

使用例

2 つの DataGridView コントロールが親子リレーションシップの 2 つのテーブルからデータを表示するマスター/詳細シナリオでこの列挙体を使用するコード例を次に示します。この例では、マスターコントロールの列サイズ変更モードは None で、列幅は、読み込まれる値に合わせてプログラムによって初期化されます。詳細コントロールは、自動サイズ変更モードに設定されているため、値が変更されるたびに列が自動的に調整されます (ユーザーが親テーブルの現在の行を変更した場合など)。この例は「方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター/詳細形式のフォームを作成する」で取り上げている例の一部です。

Visual Basic

Private Sub Form1_Load(ByVal
 sender As Object, ByVal
 e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded
 data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

private void Form1_Load(object sender, System.EventArgs
 e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded
 data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.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.AutoSizeColumnsMode プロパティ
DataGridViewColumn.AutoSizeMode
DataGridViewAutoSizeColumnMode 列挙体
System.Windows.Forms.DataGridView.AutoResizeColumns
System.Windows.Forms.DataGridView.AutoResizeColumn
その他の技術情報
Windows フォーム DataGridView コントロールのサイズ変更オプション
Windows フォーム DataGridView コントロールの列フィルモード

>> 「DataGridView.AutoSizeColumnsMode」を含む用語の索引
DataGridView.AutoSizeColumnsModeのページへのリンク

DataGridView.AutoSizeColumnsModeとは？わかりやすく解説

DataGridView.AutoSizeColumnsMode プロパティ

DataGridViewAutoSizeColumnsMode 列挙体

「DataGridView.AutoSizeColumnsMode」の関連用語


	© 2024 Microsoft.All rights reserved.

DataGridView.AutoSizeColumnsModeとは？ わかりやすく解説

DataGridView.AutoSizeColumnsMode プロパティ

DataGridViewAutoSizeColumnsMode 列挙体

急上昇のことば

「DataGridView.AutoSizeColumnsMode」の関連用語

DataGridView.AutoSizeColumnsModeとは？わかりやすく解説