DataGridViewAutoSizeColumnMode Enumeration

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
DataGridViewAutoSizeColumnMode.cs
Quelle:
DataGridViewAutoSizeColumnMode.cs
Quelle:
DataGridViewAutoSizeColumnMode.cs
Quelle:
DataGridViewAutoSizeColumnMode.cs
Quelle:
DataGridViewAutoSizeColumnMode.cs

Definiert Werte, um anzugeben, wie die Breite einer Spalte angepasst wird.

public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode = 
Public Enum DataGridViewAutoSizeColumnMode
Vererbung
Object
ValueType
Enum
DataGridViewAutoSizeColumnMode

Felder

Name Wert Beschreibung
NotSet 0

Das Größenverhalten der Spalte wird von der AutoSizeColumnsMode Eigenschaft geerbt.
None 1

Die Spaltenbreite wird nicht automatisch angepasst.
ColumnHeader 2

Die Spaltenbreite passt sich an den Inhalt der Spaltenüberschriftenzelle an.
AllCellsExceptHeader 4

Die Spaltenbreite passt sich an den Inhalt aller Zellen in der Spalte an, mit Ausnahme der Kopfzeilenzelle.
AllCells 6

Die Spaltenbreite passt sich an den Inhalt aller Zellen in der Spalte an, einschließlich der Kopfzeilenzelle.
DisplayedCellsExceptHeader 8

Die Spaltenbreite passt sich an den Inhalt aller Zellen in der Spalte an, die derzeit auf dem Bildschirm angezeigt werden, mit Ausnahme der Kopfzeilenzelle.
DisplayedCells 10

Die Spaltenbreite passt sich an den Inhalt aller Zellen in der Spalte an, die aktuell auf dem Bildschirm angezeigt werden, einschließlich der Kopfzeilenzelle.
Fill 16

Die Spaltenbreite wird so angepasst, dass die Breite aller Spalten genau den Anzeigebereich des Steuerelements ausfüllt, sodass ein horizontaler Bildlauf nur erforderlich ist, um Spaltenbreiten über den MinimumWidth Eigenschaftswerten beizubehalten. Relative Spaltenbreiten werden durch die relativen FillWeight Eigenschaftswerte bestimmt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Enumeration veranschaulicht, um eine Spalte mit fester Breite zu konfigurieren. Dieses Beispiel ist Teil eines größeren Beispiels, das in How to: Set the Sizing Modes of the Windows Forms DataGridView Control.

DataGridViewTextBoxColumn idColumn =
    new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;

Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.HeaderText = "ID"
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None
idColumn.Resizable = DataGridViewTriState.False
idColumn.ReadOnly = True
idColumn.Width = 20

Hinweise

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

Im Füllmodus wird die bevorzugte Breite einer Spalte durch Ändern der Größe aller Spalten in diesem Modus bestimmt, sodass 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 Ermitteln der neuen Breite ist nützlich, um leistungseinbußen beim Arbeiten mit vielen Datenzeilen zu vermeiden.

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

Diese Aufzählung wird von den AutoSizeMode Spalten und InheritedAutoSizeMode den Eigenschaften der Spalten und der DataGridView.AutoResizeColumn Methode verwendet.

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

Gilt für:

Weitere Informationen