DataGridViewAutoSizeColumnsMode Enum

Definition

Definierar värden för att ange hur kolumnernas bredd justeras.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
Arv
DataGridViewAutoSizeColumnsMode

Fält

Name Värde Description
None 1

Kolumnbredderna justeras inte automatiskt.

ColumnHeader 2

Kolumnbredderna justeras så att de passar innehållet i kolumnrubrikcellerna.

AllCellsExceptHeader 4

Kolumnbredderna justeras för att passa innehållet i alla celler i kolumnerna, exklusive rubrikceller.

AllCells 6

Kolumnbredderna justeras så att de passar innehållet i alla celler i kolumnerna, inklusive rubrikceller.

DisplayedCellsExceptHeader 8

Kolumnbredderna justeras för att passa innehållet i alla celler i kolumnerna som för närvarande visas på skärmen, exklusive rubrikceller.

DisplayedCells 10

Kolumnbredderna justeras för att passa innehållet i alla celler i kolumnerna som för närvarande visas på skärmen, inklusive rubrikceller.

Fill 16

Kolumnbredderna justeras så att bredden på alla kolumner exakt fyller kontrollens visningsområde, vilket kräver horisontell rullning endast för att hålla kolumnbredderna ovanför egenskapsvärdena MinimumWidth . Relativa kolumnbredder bestäms av de relativa FillWeight egenskapsvärdena.

Exempel

Följande kodexempel illustrerar användningen av den här uppräkningen i ett huvud-/informationsscenario där två DataGridView kontroller visar data från två tabeller i en överordnad/underordnad relation. I det här exemplet är kolumnstorleksläget för huvudkontrollen Ingen och kolumnbredderna initieras programmatiskt för att passa de inlästa värdena. Informationskontrollen är inställd på ett automatiskt storlekslä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

Kontrollen DataGridView kan ändra storlek på sina kolumner så att de fyller kontrollens tillgängliga vågräta bredd eller för att få dem att visa hela innehållet i alla celler eller i angivna celler.

Med Fill läget bestäms den önskade bredden för en kolumn genom att ändra storlek på alla kolumner i det läget så att alla synliga kolumner i kontrollen exakt fyller den vågräta bredden på det tillgängliga visningsområdet. Med andra lägen är den önskade kolumnbredden den minsta bredd som krävs för att visa det största cellvärdet från alla celler eller en delmängd av cellerna i kolumnen, till exempel delmängden av celler som för närvarande visas i rader. Att använda en delmängd av celler för att fastställa den nya bredden är användbart för att undvika prestandastraff när du arbetar med många rader med data.

Innehållsbaserad automatisk storleksändring hindrar användare från att justera kolumnbredder med musen. Användarens storleksändring är dock aktiverad i fyllningsläge.

Den här uppräkningen används av kontrollegenskapen DataGridViewAutoSizeColumnsMode och AutoResizeColumns -metoden.

Mer information om storlekslägen finns i Storleksalternativ i Windows Forms DataGridView Control. Mer information om kolumnfyllningsläget finns i Column Fill Mode i Windows Forms DataGridView Control.

Gäller för

Se även