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.

適用対象

こちらもご覧ください