DataGridViewAutoSizeColumnMode Enumeration

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

AllCells 6

Die Spaltenbreite wird entsprechend dem Inhalt aller Zellen in der Spalte angepasst, einschließlich der Headerzelle.
AllCellsExceptHeader 4

Die Spaltenbreite wird entsprechend dem Inhalt aller Zellen in der Spalte angepasst, ausgenommen die Headerzelle.
ColumnHeader 2

Die Spaltenbreite wird entsprechend dem Inhalt der Spaltenheaderzelle angepasst.
DisplayedCells 10

Die Spaltenbreite wird entsprechend dem Inhalt aller Zellen in der Spalte angepasst, die sich in Zeilen befinden, die aktuell auf dem Bildschirm angezeigt werden, einschließlich der Headerzelle.
DisplayedCellsExceptHeader 8

Die Spaltenbreite wird entsprechend dem Inhalt aller Zellen in der Spalte angepasst, die sich in Zeilen befinden, die aktuell auf dem Bildschirm angezeigt werden, ausgenommen die Headerzelle.
Fill 16

Die Spaltenbreite wird 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 Spaltenbreite wird nicht automatisch angepasst.
NotSet 0

Das Größenanpassungsverhalten der Spalte wird von der AutoSizeColumnsMode-Eigenschaft geerbt.

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 der 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 können.

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 zum Anzeigen des größten Zellwerts aus allen Zellen oder einer Teilmenge von Zellen in dieser Spalte erforderlich ist, z. B. die Teilmenge von Zellen, die sich in aktuell angezeigten Zeilen befinden. Die Verwendung einer Teilmenge von Zellen zum Ermitteln der neuen Breite ist nützlich, um eine Leistungsstrafe beim Arbeiten mit vielen Datenzeilen zu vermeiden.

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 Enumeration wird von den AutoSizeMode InheritedAutoSizeMode Spalten und den Eigenschaften der Spalten und der DataGridView.AutoResizeColumn Methode verwendet.

Weitere Informationen zu Größenmodi finden Sie unter Sizing Options in the Windows Forms DataGridView Control. Weitere Informationen zum Spaltenfüllmodus finden Sie im Windows Forms DataGridView-Steuerelement im Spaltenfüllmodus.

Gilt für

Siehe auch