DataGridView.AutoSizeColumnsMode プロパティ
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文Dim instance As DataGridView Dim value As DataGridViewAutoSizeColumnsMode value = instance.AutoSizeColumnsMode instance.AutoSizeColumnsMode = value
public: property DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { DataGridViewAutoSizeColumnsMode get (); void set (DataGridViewAutoSizeColumnsMode value); }
/** @property */ public DataGridViewAutoSizeColumnsMode get_AutoSizeColumnsMode () /** @property */ public void set_AutoSizeColumnsMode (DataGridViewAutoSizeColumnsMode value)
public function get AutoSizeColumnsMode () : DataGridViewAutoSizeColumnsMode public function set AutoSizeColumnsMode (value : DataGridViewAutoSizeColumnsMode)
DataGridViewAutoSizeColumnsMode 値。既定値は None です。
例外| 例外の種類 | 条件 |
|---|---|
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 コントロールを使用してマスター/詳細形式のフォームを作成する」で取り上げている例の一部です。
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 Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
DataGridViewAutoSizeColumnsMode
DataGridViewColumn.FillWeight
その他の技術情報
DataGridView コントロール (Windows フォーム)
- DataGridView.AutoSizeColumnsMode プロパティのページへのリンク
