DataGridView.AutoSizeRowsMode Eigenschaft

Definition

Ruft einen Wert ab, der angibt, wie die Zeilenhöhe bestimmt wird, oder legt ihn fest.Gets or sets a value indicating how row heights are determined.

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.A DataGridViewAutoSizeRowsMode value indicating the sizing mode. Der Standardwert ist None.The default is None.

Ausnahmen

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kein gültiger DataGridViewAutoSizeRowsMode-Wert.The specified value when setting this property is not a valid DataGridViewAutoSizeRowsMode value.

Der beim Festlegen dieser Eigenschaft angegebene Wert ist AllHeaders oder DisplayedHeaders, wenn Zeilenheader ausgeblendet sind.The specified value when setting this property is AllHeaders or DisplayedHeaders and row headers are hidden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Zeile für die automatische Größenänderung basierend auf dem Inhalt der Zeilen Header und aller Spalten festgelegt wird.The following code example demonstrates how to set the row to automatically resize based on the contents of the row headers and all of the columns. Dieses Codebeispiel ist Teil eines größeren Beispiels in Gewusst wie: Automatisches Ändern der Größe von Zellen, wenn sich der Inhalt im Windows Forms DataGridView-Steuerelement ändert.This code example is part of a larger example provided in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

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 die Zeilenhöhe automatisch an ihren Inhalt angepasst wird, wenn sich der Inhalt ändert.This property lets you configure the control so that row heights are automatically adjusted to fit their contents whenever the contents change. Wenn WrapMode aktiviert ist, werden Zeilen Höhen auch immer dann angepasst, wenn sich die Spaltenbreite ändern.If WrapMode is enabled, row heights are also adjusted whenever column widths change. Mit einigen Größen Anpassungs Modi können Sie die Größenanpassung auf die aktuell angezeigten Zeilen beschränken, um die Leistung zu steigern.Some sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Nur Zeilen mit einem- Visible Eigenschafts Wert von true werden automatisch geändert, und das Ändern der Sichtbarkeit einer Zeile führt nicht zum Ändern der Größenänderung.Only rows with a Visible property value of true are resized automatically, and changing the visibility of a row does not cause resizing to occur. Wenn für Zeilen die automatische Größenänderung festgelegt ist, kann der Benutzer außerdem die Zeilen Höhen nicht mit der Maus anpassen.Additionally, when rows are set to automatically resize, the user cannot adjust the row heights with the mouse.

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.The Height value of an automatically sized row is recalculated during layout to account for the size of the font that is used. Um den richtigen Wert zu erhalten Height , sollten Sie den Wert im Ereignis des Formulars Layout anstelle von im Konstruktor des Formulars abrufen.To get the correct Height, you should retrieve the value in the form's Layout event instead of in the form's constructor.

Um Zeilen Höhen Programm gesteuert anzupassen, verwenden Sie die- AutoResizeRow Methode oder die- AutoResizeRows Methode, oder legen Sie die Row- Height Eigenschaft festTo adjust row heights programmatically, use the AutoResizeRow or AutoResizeRows methods, or set the row Height property.

Damit der Zellen Inhalt bei der Größenänderung einer Zeile in mehrere Zeilen umbrochen wird, muss der für die Zelle geltenden Zellstil den- WrapMode Eigenschafts Wert aufweisen True .For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Weitere Informationen zur Inhalts basierten automatischen Größenanpassung finden Sie unter Größen Anpassungsoptionen im Windows Forms DataGridView-SteuerElement.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

Gilt für:

Siehe auch