DataGridView.AutoSizeColumnsMode Egenskap

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

Egenskapsvärde

Ett DataGridViewAutoSizeColumnsMode värde. Standardvärdet är None.

Undantag

Exempel

I följande kodexempel visas hur du använder den här egenskapen i ett huvud-/detaljscenario där två DataGridView kontroller visar data från två tabeller i en överordnad/underordnad relation. I det här exemplet är Nonekolumnstorleksläget för huvudkontrollen , och kolumnbredderna initieras programmatiskt för att passa de inlästa värdena. Informationskontrollen är inställd på ett automatiskt kolumnstorleksläge så att kolumnerna justeras automatiskt när värdena ändras (till exempel när användaren ändrar den aktuella raden i den överordnade tabellen). Det här exemplet är en del av ett större exempel i Hur du: Skapa ett huvud-/informationsformulär med två Windows Forms DataGridView-kontroller.

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

Kommentarer

Med den här egenskapen kan du konfigurera kontrollen så att kolumnbredderna justeras automatiskt, antingen för att fylla kontrollen eller för att passa cellinnehållet. Storleksjusteringar sker i fyllningsläge när kontrollens bredd ändras. I innehållsbaserade storlekslägen sker storleksjusteringar när cellinnehållet ändras eller, om WrapMode det är aktiverat, när radhöjderna ändras. Med vissa innehållsbaserade storlekslägen kan du begränsa storleksjusteringen till de rader som visas för närvarande för att öka prestandan.

Om du vill ändra storleksläget för en enskild kolumn anger du dess AutoSizeMode egenskap. Standardvärdet för den här egenskapen är NotSet, vilket anger att kolumnen ärver dess beteende och dess InheritedAutoSizeMode egenskapsvärde från kontrollen.

Kolumner i fyllningsläge delar upp den tillgängliga kontrollbredden i proportioner som anges av deras FillWeight egenskapsvärden. Bredden som är tillgänglig för fyllningsläget bestäms genom att subtrahera bredden på alla andra kolumner från bredden på kontrollens klientområde. Om den här bredden är mindre än de kombinerade MinimumWidth värdena för alla fyllningslägeskolumner visas den vågräta rullningslisten, alla fyllningslägeskolumner visas med minsta bredd och användarens kolumnändring inaktiveras. Mer information om fyllningsläget för kolumner finns i Column Fill Mode i Windows Forms DataGridView Control.

Endast kolumner med egenskapsvärdet Visibletrue ändras automatiskt, och om du ändrar synligheten för en kolumn sker inte storleksändringen. När kolumner är inställda på att automatiskt ändra storlek kan användaren dessutom inte justera kolumnbredderna med musen.

Om du vill justera kolumnbredderna programmatiskt använder du AutoResizeColumn metoderna eller AutoResizeColumns eller anger kolumnegenskapen Width .

Mer information om innehållsbaserad automatisk storleksändring finns i Storleksalternativ i Windows Forms DataGridView Control.

Se även

• DataGridViewAutoSizeColumnsMode
• FillWeight
• DataGridView Control (Windows Forms)