DataGridView.AutoSizeRowsMode Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab, der angibt, wie die Zeilenhöhe bestimmt wird, oder legt ihn fest.

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

Eigenschaftswert

DataGridViewAutoSizeRowsMode

Ein DataGridViewAutoSizeRowsMode-Wert, der den Größenanpassungsmodus angibt. Der Standardwert ist None.

Ausnahmen

InvalidEnumArgumentException

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kein gültiger DataGridViewAutoSizeRowsMode-Wert.

InvalidOperationException

Der beim Festlegen dieser Eigenschaft angegebene Wert ist AllHeaders oder DisplayedHeaders, wenn Zeilenheader ausgeblendet sind.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Die Zeilengröße basierend auf dem Inhalt der Zeilenheader und aller Spalten automatisch geändert wird. Dieses Codebeispiel ist Teil eines größeren Beispiels in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView-Steuerelement.

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}

private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

Hinweise

Mit dieser Eigenschaft können Sie das Steuerelement so konfigurieren, dass Zeilenhöhen automatisch an ihren Inhalt angepasst werden, wenn sich der Inhalt ändert. Wenn WrapMode aktiviert ist, werden zeilenhöhen ebenfalls angepasst, wenn sich die Spaltenbreite ändert. Mit einigen Größenmodi können Sie die Größenanpassung auf die aktuell angezeigten Zeilen beschränken, um die Leistung zu erhöhen.

Nur Zeilen mit dem Visible Eigenschaftswert von true werden automatisch geändert, und das Ändern der Sichtbarkeit einer Zeile führt nicht dazu, dass die Größe geändert wird. Wenn Zeilen auf automatische Größenänderung festgelegt sind, kann der Benutzer die Zeilenhöhen nicht mit der Maus anpassen.

Der Height Wert einer Zeile mit automatischer Größe wird während des Layouts neu berechnet, um die Größe der verwendeten Schriftart zu berücksichtigen. Um die richtige Heightabzurufen, sollten Sie den Wert im Ereignis des Formulars Layout und nicht im Konstruktor des Formulars abrufen.

Verwenden Sie zum programmgesteuerten Anpassen von Zeilenhöhen die AutoResizeRow -Methode oder AutoResizeRows oder legen Sie die zeileneigenschaft Height fest.

Damit Zellinhalte in mehrere Zeilen umschließen können, wenn die Größe einer Zeile geändert wird, muss die für die Zelle wirksamen Zellenformat den WrapMode Eigenschaftswert aufweisen True.

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

Gilt für:

Weitere Informationen