DataGridView.AutoSizeColumnsMode DataGridView.AutoSizeColumnsMode DataGridView.AutoSizeColumnsMode DataGridView.AutoSizeColumnsMode Property

定義

列の幅を決定する方法を示す値を取得または設定します。Gets or sets a value indicating how column widths are determined.

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

プロパティ値

例外

このプロパティの設定時に指定した値が、有効な DataGridViewAutoSizeColumnsMode 値ではありません。The specified value when setting this property is not a valid DataGridViewAutoSizeColumnsMode value.

このプロパティの設定時に指定した値が ColumnHeader で、列ヘッダーは非表示に指定されており、表示されている列の少なくとも 1 つの AutoSizeMode プロパティの値が NotSet です。The specified value when setting this property is ColumnHeader, column headers are hidden, and at least one visible column has an AutoSizeMode property value of NotSet.

- または --or- このプロパティの設定時に指定した値が Fill で、表示されている列のうち AutoSizeMode プロパティの値が NotSet になっているものの少なくとも 1 つが固定されています。The specified value when setting this property is Fill and at least one visible column with an AutoSizeMode property value of NotSet is frozen.

次のコード例は、2 つが、マスター/詳細のシナリオでこのプロパティを使用する方法を示しています。DataGridViewコントロールが親/子リレーションシップの 2 つのテーブルからデータを表示します。The following code example illustrates how to use this property in a master/detail scenario where two DataGridView controls display data from two tables in a parent/child relationship. この例では、マスターのコントロールの列のサイズ変更モードはNone、され、列の幅が読み込まれた値に合わせてプログラムで初期化します。In this example, the column sizing mode for the master control is None, and the column widths are programmatically initialized to fit the loaded values. 詳細コントロールは、(たとえば、ユーザーは、親テーブルの現在の行を変更) ときに、値が変更されるたびに列が自動的に調整するために、列の自動サイズ変更モードに設定されます。The details control is set to an automatic column sizing mode so that columns will adjust automatically whenever the values change (for example, when the user changes the current row in the parent table). この例で使用できる例の一部は、方法。2 つの Windows フォーム DataGridView コントロールを使用してマスター/詳細フォームを作成するします。This example is part of a larger example available in How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

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;
}
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

注釈

このプロパティを使用して、コントロールに入力するか、セルの内容に合わせて列の幅が自動的に調整するために、コントロールを構成できます。This property lets you configure the control so that column widths are automatically adjusted either to fill the control or to fit cell contents. サイズの調整は、コントロールの幅が変更されるたびに、フィル モードで発生します。Size adjustments occur in fill mode whenever the width of the control changes. セルの内容を変更する場合、または場合、コンテンツ ベースのサイズ変更モードでサイズの調整が発生するWrapModeが有効にすると、行の高さを変更します。In content-based sizing modes, size adjustments occur whenever cell contents change or, if WrapMode is enabled, whenever row heights change. 一部のコンテンツ ベースのサイズ変更モードを使用して、パフォーマンスが向上するために現在表示されている行のサイズ調整を制限できます。Some content-based sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

個々 の列のサイズ変更モードを変更するには、次のように設定します。 そのAutoSizeModeプロパティ。To change the sizing mode for an individual column, set its AutoSizeMode property. このプロパティの既定値はNotSet、列がその動作を継承することを示すし、そのInheritedAutoSizeModeコントロールからプロパティ値。The default value of this property is NotSet, indicating that the column inherits its behavior and its InheritedAutoSizeMode property value from the control.

フィル モード列の分割で示される比率に基づいて使用可能なコントロールの幅、FillWeightプロパティの値。Columns in fill mode divide the available control width in proportions indicated by their FillWeight property values. フィル モードの使用可能な幅は、コントロールのクライアント領域の幅から他のすべての列の幅を減算によって決まります。The width available for fill mode is determined by subtracting the widths of all other columns from the width of the client area of the control. この幅の合計より小さい場合MinimumWidthのすべてのフィル モード列の値は、水平スクロール バーが表示されます、すべてのフィル モード列は、最小の幅で表示され、ユーザー列のサイズ変更が無効になっています。If this width is smaller than the combined MinimumWidth values of all fill-mode columns, the horizontal scroll bar is displayed, all fill-mode columns are shown with their minimum widths, and user column-resizing is disabled. 列フィル モードの詳細については、次を参照してください。 Windows フォーム DataGridView コントロールの列フィル モードします。For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

持つ列のみをVisibleプロパティ値のtrueが自動的にサイズ変更される列の表示を変更しても発生するサイズ変更は発生しません。Only columns with a Visible property value of true are resized automatically, and changing the visibility of a column does not cause resizing to occur. さらに、列が自動的にサイズを変更する設定されている場合、ユーザーは、マウスで列の幅を調整できません。Additionally, when columns are set to automatically resize, the user cannot adjust the column widths with the mouse.

プログラムで列の幅を調整するには、使用、AutoResizeColumnまたはAutoResizeColumnsメソッドまたは列セットWidthプロパティ。To adjust column widths programmatically, use the AutoResizeColumn or AutoResizeColumns methods or set the column Width property.

コンテンツ ベースの自動サイズ変更の詳細については、次を参照してください。 Windows フォームの DataGridView コントロールのサイズ変更オプションします。For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

適用対象

こちらもご覧ください