DataGridViewAutoSizeColumnsMode 列挙型

定義

列幅を調整する方法を指定するための値を定義します。

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

フィールド

AllCells 6

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

AllCellsExceptHeader 4

列幅は、ヘッダー セルを除く列内のすべてのセルの内容に合わせて調整されます。

ColumnHeader 2

列幅は、列ヘッダー セルの内容に合わせて調整されます。

DisplayedCells 10

列幅は、ヘッダー セルを含む列内のすべてのセルのうち、現在画面に表示されている行に含まれるセルの内容に合わせて調整されます。

DisplayedCellsExceptHeader 8

列幅は、ヘッダー セルを除く列内のすべてのセルのうち、現在画面に表示されている行に含まれるセルの内容に合わせて調整されます。

Fill 16

すべての列がコントロールの表示領域の幅いっぱいに表示されるよう、列幅が調整されます。水平スクロールは、列幅を MinimumWidth プロパティの値より大きくする場合にのみ必要です。 関連する列の幅は、関連する FillWeight プロパティ値によって決定されます。

None 1

列幅は自動的に調整されません。

次のコード例は、2 つのコントロールが親/子リレーションシップの 2 つの DataGridView テーブルのデータを表示するマスター/詳細シナリオでのこの列挙の使用を示しています。 この例では、マスター コントロールの列サイズ設定モードは None で、読み込まれた値に合わせて列幅がプログラムによって初期化されます。 詳細コントロールは自動サイズ設定モードに設定されるため、値が変更されるたびに列が自動的に調整されます (たとえば、ユーザーが親テーブルの現在の行を変更したときなど)。 この例は、「方法: 2 つのWindows フォーム DataGridView コントロールを使用してマスター/詳細フォームを作成する」で使用できる大きな例の一部です。

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 、その列のサイズを変更して、コントロールの使用可能な水平方向の幅を埋めたり、すべてのセルまたは指定したセルの完全な内容を表示したりできます。

モードでは Fill 、列の推奨幅は、コントロール内のすべての表示列が使用可能な表示領域の水平方向の幅を正確に埋めるように、そのモードのすべての列のサイズを変更することによって決定されます。 その他のモードでは、推奨される列幅は、現在表示されている行にあるセルのサブセットなど、すべてのセルまたはその列のセルのサブセットから最大のセル値を表示するために必要な最小幅です。 セルのサブセットを使用して新しい幅を決定すると、多くのデータ行を操作するときにパフォーマンスの低下を回避するのに役立ちます。

コンテンツベースの自動サイズ変更により、ユーザーはマウスで列の幅を調整できなくなります。 ただし、ユーザーのサイズ変更はフィル モードで有効になっています。

この列挙体は、コントロールAutoSizeColumnsModeDataGridViewプロパティとAutoResizeColumnsメソッドによって使用されます。

サイズ設定モードの詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。 特に列の塗りつぶしモードの詳細については、「Windows フォーム DataGridView コントロールの列の塗りつぶしモード」を参照してください。

適用対象

こちらもご覧ください