DataGridViewColumn.AutoSizeMode Eigenschaft

  • Referenz

Definition

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

Ruft den Modus ab, in dem die Spalte automatisch ihre Breite anpasst, oder legt diesen Modus fest.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }
member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set
Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

Eigenschaftswert

DataGridViewAutoSizeColumnMode

Ein DataGridViewAutoSizeColumnMode-Wert, der bestimmt, ob die Spalte ihre Breite automatisch anpasst und wie sie ihre bevorzugte Breite bestimmt. Der Standardwert ist NotSet.

Ausnahmen

InvalidEnumArgumentException

Der beim Festlegen dieser Eigenschaft angegebene Wert stellt einen DataGridViewAutoSizeColumnMode dar, der nicht gültig ist.

InvalidOperationException

Der beim Festlegen dieser Eigenschaft angegebene Wert führt zu dem InheritedAutoSizeMode-Wert ColumnHeader für eine sichtbare Spalte, wenn Spaltenheader ausgeblendet sind.

- oder -

Der beim Festlegen dieser Eigenschaft angegebene Wert führt zu dem InheritedAutoSizeMode-Wert Fill für eine sichtbare Spalte, die fixiert ist.

Beispiele

Im folgenden Codebeispiel wird erzwungen, dass die Breite einer Spalte automatisch an den Inhalt angepasst wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataGridViewColumn-Klasse bereitgestellt wird.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Hinweise

Das automatische Größenanpassungsverhalten der Spalte wird durch den Wert der InheritedAutoSizeMode -Eigenschaft bestimmt, der dem Wert der AutoSizeMode -Eigenschaft für alle Werte mit Ausnahme NotSetvon entspricht, was angibt, dass der Wert stattdessen von der DataGridView.AutoSizeColumnsMode -Eigenschaft geerbt wird.

Wenn der InheritedAutoSizeMode -Eigenschaftswert ist Fill, wird die Größe der Spalte zusammen mit anderen Spalten in diesem Modus geändert. Alle Füllmodusspalten im Steuerelement teilen den verfügbaren Raum in Proportionen, die durch ihre FillWeight Eigenschaftswerte bestimmt werden. Die für den Füllmodus verfügbare Breite wird durch Subtrahieren der Breite aller anderen Spalten von der Breite des Clientbereichs des Steuerelements bestimmt. Wenn diese Breite kleiner als die kombinierten MinimumWidth Werte aller Spalten im Füllmodus ist, wird die horizontale Bildlaufleiste angezeigt, alle Füllmodusspalten werden mit ihrer Mindestbreite angezeigt, und die Größenänderung der Benutzerspalten ist deaktiviert. Weitere Informationen zum Spaltenfüllmodus finden Sie unter Spaltenfüllmodus im Windows Forms DataGridView-Steuerelement.

Wenn die InheritedAutoSizeMode -Eigenschaft auf einen anderen Wert außer Nonefestgelegt ist, verwaltet die Spalte ihre Breite, sodass ihre Zellenwerte vollständig ohne Beschneidung angezeigt werden. In inhaltsbasierten Größenanpassungsmodi werden Größenanpassungen immer dann vorgenommen, wenn sich der Zellinhalt ändert oder, wenn WrapMode aktiviert ist, wenn sich die Zeilenhöhe ändert. Mit einigen inhaltsbasierten Größenmodi können Sie die Größenanpassung auf die aktuell angezeigten Zeilen einschränken, um die Leistung zu steigern.

Nur Spalten mit dem Visible Eigenschaftswert werden in ihrer true Größe geändert, und das Ändern der Sichtbarkeit einer Spalte führt nicht zu einer Größenänderung. Darüber hinaus kann der Benutzer die Spaltenbreite nicht mit der Maus anpassen, wenn die Spaltengröße automatisch geändert wird.

Verwenden Sie zum programmgesteuerten Anpassen der Spaltenbreiten die -Methode oder die DataGridView -Methode des Steuerelements AutoResizeColumn , AutoResizeColumns oder legen Sie die column-Eigenschaft Width fest.

Weitere Informationen zur inhaltsbasierten automatischen Größenanpassung finden Sie unter Größenanpassungsoptionen im Windows Forms DataGridView-Steuerelement.

Gilt für:

Weitere Informationen