Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DataGridView.AutoSizeColumnsMode-Eigenschaft
Ruft einen Wert ab, der angibt, wie die Spaltenbreite bestimmt wird, oder legt sie fest.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Eigenschaftswert
Typ: System.Windows.Forms.DataGridViewAutoSizeColumnsModeEin DataGridViewAutoSizeColumnsMode-Wert. Der Standardwert ist None.
| Ausnahme | Bedingung |
|---|---|
| InvalidEnumArgumentException |
Der angegebene Wert beim Festlegen dieser Eigenschaft ist kein gültiger DataGridViewAutoSizeColumnsMode-Wert. |
| InvalidOperationException |
Der beim Festlegen dieser Eigenschaft angegebene Wert ist ColumnHeader, Spaltenheader sind ausgeblendet, und mindestens eine sichtbare Spalte hat den AutoSizeMode-Eigenschaftswert NotSet. – oder – Der beim Festlegen dieser Eigenschaft angegebene Wert ist Fill, und mindestens eine angezeigte Spalte mit dem AutoSizeMode-Eigenschaftswert NotSet ist fixiert. |
Mit dieser Eigenschaft können Sie das Steuerelement konfigurieren, sodass die jeweilige Spaltenbreite automatisch an das Steuerelement oder den Inhalt der Zellen angepasst wird. Größenanpassungen erfolgen im Füllmodus, wenn sich die Breite des Steuerelements ändert. In inhaltsbasierten Modi erfolgen Größenanpassungen, wenn sich der Inhalt der Zelle ändert oder (wenn WrapMode aktiviert ist) wenn sich die Höhe von Zeilen ändert. In einigen inhaltsbasierten Größenanpassungsmodi können Sie die Größenanpassung auf die gerade angezeigten Zeilen beschränken, um die Leistung zu verbessern.
Legen Sie zum Ändern des Größenanpassungsmodus für eine einzelne Spalte deren AutoSizeMode-Eigenschaft fest. Der Standardwert dieser Eigenschaft ist NotSet und gibt an, dass die Spalte ihr Verhalten und ihren InheritedAutoSizeMode-Eigenschaftswert vom Steuerelement erbt.
Spalten in Füllmodus teilen die verfügbare Breite des Steuerelements in Abschnitte, die von ihren FillWeight-Eigenschaftswerten angegeben werden. Die für den Füllmodus verfügbare Breite wird durch Subtrahieren der Breite aller Spalten von der Breite des Clientbereichs des Steuerelements bestimmt. Wenn die Breite geringer ist, als die Summe der MinimumWidth-Werte aller Spalten im Füllmodus, wird die horizontale Schiebeleiste angezeigt, alle Spalten im Füllmodus werden mit der Mindestbreite angezeigt, und die Größenänderung der Spalten durch den Benutzer wird deaktiviert. Weitere Informationen zum Spaltenfüllmodus finden Sie unter Spaltenfüllmodus im DataGridView-Steuerelement in Windows Forms.
Nur die Größe von Spalten mit dem Visible-Eigenschaftswert true wird automatisch angepasst. Durch das Ändern der Sichtbarkeit einer Spalte wird deren Größe nicht geändert. Wenn außerdem Spalten auf automatische Größenänderung festgelegt werden, kann die Spaltenbreite nicht mit der Maus geändert werden.
Zum programmgesteuerten Anpassen der Spaltenbreite verwenden Sie die AutoResizeColumn-Methode oder die AutoResizeColumns-Methode, oder legen Sie die Width-Eigenschaft der Spalte fest.
Weitere Informationen zur inhaltsbasierten automatischen Größenänderung finden Sie unter Größenänderungsoptionen im DataGridView-Steuerelement in Windows Forms.
Im folgenden Codebeispiel wird veranschaulicht, wie diese Eigenschaft in einem hierarchischen Szenario verwendet wird, in dem in zwei DataGridView-Steuerelementen Daten aus zwei Tabellen angezeigt werden, zwischen denen eine hierarchische Beziehung besteht. In diesem Beispiel ist None der Modus zum Festlegen der Spaltengröße des übergeordneten Steuerelements, und die jeweilige Spaltenbreite wird programmgesteuert initialisiert, um die geladenen Werte aufnehmen zu können. Das untergeordnete Steuerelement wird auf einen Modus zum automatischen Anpassen der Größe festgelegt, sodass Spalten bei jeder Änderung von Werten automatisch angepasst werden (z. B. beim Ändern der aktuellen Zeile in der übergeordneten Tabelle). Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels in Gewusst wie: Erstellen eines Master-/Detailformulars mit zwei DataGridView-Steuerelementen in Windows Forms.
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; }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Möchten Sie an der Umfrage teilnehmen?
