DataGridViewAutoSizeColumnMode 列挙体とは何？わかりやすく解説 Weblio辞書

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

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

DataGridViewAutoSizeColumnMode 列挙体

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

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

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

Visual Basic (宣言)

Public Enumeration DataGridViewAutoSizeColumnMode

Visual Basic (使用法)

Dim instance As DataGridViewAutoSizeColumnMode

public enum DataGridViewAutoSizeColumnMode

C++

public enum class DataGridViewAutoSizeColumnMode

public enum DataGridViewAutoSizeColumnMode

JScript

public enum DataGridViewAutoSizeColumnMode

メンバ

	メンバ名	説明
	AllCells	列幅は、列のすべてのセル (ヘッダーセルを含む) の内容に合わせて調整されます。
	AllCellsExceptHeader	列幅は、列のすべてのセル (ヘッダーセルを除く) の内容に合わせて調整されます。
	ColumnHeader	列幅は、列ヘッダーセルの内容に合わせて調整されます。
	DisplayedCells	列幅は、ヘッダーセルを含む、現在画面に表示されている行の列の全セルの内容に合わせて調整されます。
	DisplayedCellsExceptHeader	列幅は、ヘッダーセルを除く、現在画面に表示されている行の列の全セルの内容に合わせて調整されます。
	Fill	列幅は、すべての列の列幅の合計がコントロールの表示領域全体を埋めるように調整され、列幅が DataGridViewColumn.MinimumWidth プロパティ値を上回った状態を保持するためだけに水平スクロールを必要とします。関連する列の幅は、関連する DataGridViewColumn.FillWeight プロパティ値によって決定されます。
	None	列幅は自動的に調整されません。
	NotSet	列のサイズ変更の動作は、DataGridView.AutoSizeColumnsMode プロパティから継承されます。

解説

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

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

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

この列挙体は、列の AutoSizeMode プロパティと InheritedAutoSizeMode プロパティ、および System.Windows.Forms.DataGridView.AutoResizeColumn メソッドで使用されます。

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

使用例

この列挙体を使用して、固定幅の列を設定するコード例を次に示します。次の例は「方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する」で取り上げている例の一部です。

DataGridViewTextBoxColumn idColumn = new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;

プラットフォーム

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