DataGridViewAutoSizeColumnsMode DataGridViewAutoSizeColumnsMode DataGridViewAutoSizeColumnsMode DataGridViewAutoSizeColumnsMode Enum

定義

列幅を調整する方法を指定するための値を定義します。Defines values for specifying how the widths of columns are adjusted.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
継承
DataGridViewAutoSizeColumnsModeDataGridViewAutoSizeColumnsModeDataGridViewAutoSizeColumnsModeDataGridViewAutoSizeColumnsMode

フィールド

AllCells AllCells AllCells AllCells 6

列幅は、ヘッダー セルを含む列内のすべてのセルの内容に合わせて調整されます。The column widths adjust to fit the contents of all cells in the columns, including header cells.

AllCellsExceptHeader AllCellsExceptHeader AllCellsExceptHeader AllCellsExceptHeader 4

列幅は、ヘッダー セルを除く列内のすべてのセルの内容に合わせて調整されます。The column widths adjust to fit the contents of all cells in the columns, excluding header cells.

ColumnHeader ColumnHeader ColumnHeader ColumnHeader 2

列幅は、列ヘッダー セルの内容に合わせて調整されます。The column widths adjust to fit the contents of the column header cells.

DisplayedCells DisplayedCells DisplayedCells DisplayedCells 10

列幅は、ヘッダー セルを含む列内のすべてのセルのうち、現在画面に表示されている行に含まれるセルの内容に合わせて調整されます。The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, including header cells.

DisplayedCellsExceptHeader DisplayedCellsExceptHeader DisplayedCellsExceptHeader DisplayedCellsExceptHeader 8

列幅は、ヘッダー セルを除く列内のすべてのセルのうち、現在画面に表示されている行に含まれるセルの内容に合わせて調整されます。The column widths adjust to fit the contents of all cells in the columns that are in rows currently displayed onscreen, excluding header cells.

Fill Fill Fill Fill 16

すべての列がコントロールの表示領域の幅いっぱいに表示されるよう、列幅が調整されます。水平スクロールは、列幅を MinimumWidth プロパティの値より大きくする場合にのみ必要です。The column widths adjust so that the widths of all columns exactly fill the display area of the control, requiring horizontal scrolling only to keep column widths above the MinimumWidth property values. 関連する列の幅は、関連する FillWeight プロパティ値によって決定されます。Relative column widths are determined by the relative FillWeight property values.

None None None None 1

列幅は自動的に調整されません。The column widths do not automatically adjust.

次のコード例は、2 つの場所にマスター/詳細シナリオでは、この列挙体の使用を示しますDataGridViewコントロールが親/子リレーションシップの 2 つのテーブルからデータを表示します。The following code example illustrates the use of this enumeration in a master/details 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 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

注釈

DataGridViewコントロールがコントロールの使用可能な水平方向の幅を入力できるようにするか、または指定したセルのすべてのセルの内容がすべて表示できるように、その列のサイズを変更します。The DataGridView control can resize its columns to make them fill the available horizontal width of the control or to make them display the full contents of all cells or of specified cells.

Fillによってコントロールに表示されているすべての列が使用可能な表示領域の水平方向の幅を正確に入力できるように、そのモードですべての列をサイズ変更モードでは、列の幅が決定されます。With Fill mode, the preferred width of a column is determined by resizing all columns in that mode so that all visible columns in the control exactly fill the horizontal width of the available display area. その他のモードでは、最適な列幅は現在表示されている行に含まれるセルのサブセットなど、その列のすべてのセルまたはセルのサブセットから最大のセル値を表示するために必要な最小の幅。With other modes, the preferred column width is the minimum width required to display the largest cell value from all cells or a subset of cells in that column, such as the subset of cells that are in currently displayed rows. セルのサブセットを使用して新しい幅を決定するは、多くのデータ行を使用する場合、パフォーマンスの低下を回避するために便利です。Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

コンテンツ ベースの自動サイズ変更すると、ユーザーがマウスで列の幅を調整することはできません。Content-based automatic resizing prevents users from adjusting column widths with the mouse. ユーザーによるサイズ変更が有効になっている、塗りつぶしモードでただし。User resizing is enabled in fill mode, however.

この列挙体を使って、DataGridViewコントロールAutoSizeColumnsModeプロパティとAutoResizeColumnsメソッド。This enumeration is used by the DataGridView control AutoSizeColumnsMode property and AutoResizeColumns method.

サイズ変更モードの詳細については、次を参照してください。 Windows フォーム DataGridView コントロールでサイズ変更オプションします。For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. 列フィル モードの詳細については具体的には、参照Windows フォーム DataGridView コントロールの列フィル モードします。For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

適用対象

こちらもご覧ください