DataGridViewColumn.AutoSizeMode プロパティ

  • リファレンス

定義

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

列の幅を自動的に調整するときに使用するモードを取得または設定します。

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }
member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set
Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

プロパティ値

DataGridViewAutoSizeColumnMode

列がその幅を自動的に調整するかどうか、および適切な幅を決定する方法を決定する DataGridViewAutoSizeColumnMode 値。 既定値は、NotSet です。

例外

InvalidEnumArgumentException

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

InvalidOperationException

このプロパティの設定時に指定された値では、列ヘッダーが非表示のときに、表示される列の InheritedAutoSizeMode 値が ColumnHeader になります。

- または -

このプロパティの設定時に指定された値では、固定された表示列の InheritedAutoSizeMode 値が Fill になります。

例

次のコード例では、列の幅が内容に合わせて自動的にサイズ変更されるように強制します。 このコード例は、DataGridViewColumn クラスのために提供されている大規模な例の一部です。

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

注釈

列の自動サイズ設定動作は、 プロパティのInheritedAutoSizeMode値によって決まります。これは、 を除くNotSetすべての値のプロパティのAutoSizeMode値と同じです。これは、値が代わりに プロパティからDataGridView.AutoSizeColumnsMode継承されることを示します。

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

プロパティが InheritedAutoSizeMode を除く None他の値に設定されている場合、列は幅を管理し、セル値がクリッピングなしで完全に表示されるようにします。 コンテンツ ベースのサイズ設定モードでは、セルの内容が変更されるたびにサイズ調整が行われます。有効になっている場合 WrapMode は、行の高さが変更されるたびにサイズ調整が行われます。 一部のコンテンツ ベースのサイズ設定モードでは、パフォーマンスを向上させるために、現在表示されている行にサイズ調整を制限できます。

プロパティ値が Visible の true 列のみがサイズ変更され、列の可視性を変更してもサイズ変更は発生しません。 さらに、列のサイズが自動的に変更されるように設定されている場合、ユーザーはマウスで列の幅を調整できません。

プログラムで列の幅を調整するには、コントロールAutoResizeColumnまたは AutoResizeColumns メソッドをDataGridView使用するか、column Width プロパティを設定します。

コンテンツ ベースの自動サイズ設定の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

適用対象

こちらもご覧ください