DataGridViewAutoSizeColumnsMode Enumeration

Definition

Definiert Werte für die Angabe, wie die Breite von Spalten angepasst werden soll.

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

Felder

AllCells 6

Die Spaltenbreiten werden an die Inhalte aller Zellen in den Spalten angepasst, einschließlich der Headerzellen.

AllCellsExceptHeader 4

Die Spaltenbreiten werden an die Inhalte aller Zellen in den Spalten angepasst, mit Ausnahme der Headerzellen.

ColumnHeader 2

Die Spaltenbreiten werden an die Inhalte der Spaltenheaderzellen angepasst.

DisplayedCells 10

Die Spaltenbreiten werden an die Inhalte aller Zellen in den Spalten angepasst, die sich in derzeit auf dem Bildschirm angezeigten Zeilen befinden, einschließlich der Headerzellen.

DisplayedCellsExceptHeader 8

Die Spaltenbreiten werden an die Inhalte aller Zellen in den Spalten angepasst, die sich in derzeit auf dem Bildschirm angezeigten Zeilen befinden, mit Ausnahme der Headerzellen.

Fill 16

Die Spaltenbreiten werden so angepasst, dass die Breiten aller Spalten den Anzeigebereich des Steuerelements genau und vollständig ausfüllen. Das heißt, dass die horizontale Bildlauffunktion nur für Spalten beibehalten werden muss, deren Breite die MinimumWidth-Eigenschaftswerte überschreitet. Relative Spaltenbreiten werden durch die relativen FillWeight-Eigenschaftswerte bestimmt.

None 1

Die Spaltenbreiten werden nicht automatisch angepasst.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung dieser Enumeration in einem Master-/Detailszenario, in dem zwei DataGridView Steuerelemente Daten aus zwei Tabellen in einer übergeordneten/untergeordneten Beziehung anzeigen. In diesem Beispiel ist der Spaltendimensionierungsmodus für das Mastersteuerelement Keine, und die Spaltenbreiten werden programmgesteuert initialisiert, um den geladenen Werten zu entsprechen. Das Detailsteuerelement ist auf einen automatischen Größenmodus festgelegt, sodass Spalten automatisch angepasst werden, wenn sich die Werte ändern (z. B. wenn der Benutzer die aktuelle Zeile in der übergeordneten Tabelle ändert). Dieses Beispiel ist Teil eines größeren Beispiels, das unter How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls verfügbar ist.

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

Hinweise

Das DataGridView Steuerelement kann die Größe seiner Spalten ändern, damit sie die verfügbare horizontale Breite des Steuerelements ausfüllen oder den vollständigen Inhalt aller Zellen oder der angegebenen Zellen anzeigen.

Beim Fill Modus wird die bevorzugte Breite einer Spalte bestimmt, indem die Größe aller Spalten in diesem Modus so geändert wird, dass alle sichtbaren Spalten im Steuerelement genau die horizontale Breite des verfügbaren Anzeigebereichs ausfüllen. Bei anderen Modi ist die bevorzugte Spaltenbreite die Mindestbreite, die erforderlich ist, um den größten Zellwert aus allen Zellen oder eine Teilmenge von Zellen in dieser Spalte anzuzeigen, z. B. die Teilmenge der Zellen, die sich in derzeit angezeigten Zeilen befinden. Die Verwendung einer Teilmenge von Zellen zum Bestimmen der neuen Breite ist nützlich, um leistungseinbußen bei der Arbeit mit vielen Datenzeilen zu vermeiden.

Die inhaltsbasierte automatische Größenänderung verhindert, dass Benutzer spaltenbreiten mit der Maus anpassen können. Die Größenänderung des Benutzers ist jedoch im Füllmodus aktiviert.

Diese Enumeration wird von der Steuerelementeigenschaft AutoSizeColumnsMode und AutoResizeColumns -DataGridViewmethode verwendet.

Weitere Informationen zu Größenmodi finden Sie unter Größenanpassungsoptionen im Windows Forms DataGridView-Steuerelements. Weitere Informationen zum Spaltenfüllmodus finden Sie unter Spaltenfüllmodus im Windows Forms DataGridView-Steuerelement.

Gilt für:

Weitere Informationen