DataGridView.AutoResizeColumns メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

セルの内容に合わせてすべての列の幅を調整します。

オーバーロード

AutoResizeColumns()

ヘッダー セルを含むすべてのセルの内容に合わせて、すべての列の幅を調整します。
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

指定されたサイズ モードを使用して、すべての列の幅を調整します。
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

指定されたサイズ モードを使用してすべての列の幅を調整します。オプションで、行の高さが後で調整されることを見込んで幅を計算します。

AutoResizeColumns()

ヘッダー セルを含むすべてのセルの内容に合わせて、すべての列の幅を調整します。

public:
 void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()

例

次のコード例では、列と列ヘッダーの内容に合わせてすべての列のサイズを変更します。 このコード例は、「方法: Windows フォーム DataGridView コントロールのコンテンツに合わせてセルのサイズをプログラムで変更する」で提供されるより大きな例の一部です。

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}

private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}

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

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

注釈

このメソッドは、列のサイズを変更するタイミングを制御する場合に便利です。 列の幅は、メソッド呼び出しごとに 1 回だけ調整されます。後で列の内容が変更された場合、列は自動的に調整されません。 特定の列のサイズを変更するには、メソッドを AutoResizeColumn 使用します。 内容が変更されるたびに列のサイズを自動的に変更するように設定するには、プロパティまたは列AutoSizeModeプロパティを使用AutoSizeColumnsModeします。

プログラムによるサイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

こちらもご覧ください

適用対象

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

指定されたサイズ モードを使用して、すべての列の幅を調整します。

public:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)

パラメーター

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

DataGridViewAutoSizeColumnsMode 値のいずれか 1 つ。

例外

InvalidOperationException

autoSizeColumnsMode の値が ColumnHeader であり、かつ ColumnHeadersVisible が false です。

ArgumentException

autoSizeColumnsMode の値は None または Fill です。

InvalidEnumArgumentException

autoSizeColumnsMode は有効な DataGridViewAutoSizeColumnsMode 値ではありません。

例

次のコード例では、列と列ヘッダーの内容に合わせてすべての列のサイズを変更します。 このコード例は、「方法: Windows フォーム DataGridView コントロールのコンテンツに合わせてセルのサイズをプログラムで変更する」で提供されるより大きな例の一部です。

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}

private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}

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

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

注釈

このメソッドは、列のサイズを変更するタイミングを制御する場合に便利です。 列の幅は、メソッド呼び出しごとに 1 回だけ調整されます。後で列の内容が変更された場合、列は自動的に調整されません。 特定の列のサイズを変更するには、メソッドを AutoResizeColumn 使用します。 内容が変更されるたびに列のサイズを自動的に変更するように設定するには、プロパティまたは列AutoSizeModeプロパティを使用AutoSizeColumnsModeします。

このオーバーロードを使用すると、表示される行のみなど、限られたセルセットの値に基づいて新しい幅を計算するサイズ設定モードを指定できます。 これにより、コントロールに多数の行が含まれている場合のパフォーマンスが向上します。

プログラムによるサイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

こちらもご覧ください

適用対象

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

指定されたサイズ モードを使用してすべての列の幅を調整します。オプションで、行の高さが後で調整されることを見込んで幅を計算します。

protected:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)

パラメーター

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

DataGridViewAutoSizeColumnsMode 値のいずれか 1 つ。

fixedHeight
Boolean

現在の行の高さに基づいて新しい幅を計算する場合は true。行の高さも調整されることを見込んで幅を計算する場合は false。

例外

InvalidOperationException

autoSizeColumnsMode の値が ColumnHeader であり、かつ ColumnHeadersVisible が false です。

ArgumentException

autoSizeColumnsMode の値は None または Fill です。

InvalidEnumArgumentException

autoSizeColumnsMode は有効な DataGridViewAutoSizeColumnsMode 値ではありません。

注釈

このメソッドは、列のサイズを変更するタイミングを制御する場合に便利です。 列の幅は、メソッド呼び出しごとに 1 回だけ調整されます。後で列の内容が変更された場合、列は自動的に調整されません。 特定の列のサイズを変更するには、メソッドを AutoResizeColumn 使用します。 内容が変更されるたびに列のサイズを自動的に変更するように設定するには、プロパティまたは列AutoSizeModeプロパティを使用AutoSizeColumnsModeします。

このオーバーロードを使用すると、表示される行のみなど、限られたセルセットの値に基づいて新しい幅を計算するサイズ設定モードを指定できます。 これにより、コントロールに多数の行が含まれている場合のパフォーマンスが向上します。

このオーバーロードは保護されており、派生 DataGridView クラスで理想的なセルの高さと幅の比率を実現できるように設計されています。 ある場合fixedHeight、false列の幅は、次に or AutoResizeRows メソッドを呼び出AutoResizeRowす予定で計算されます。

プログラムによるサイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

こちらもご覧ください

適用対象