DataGridView.AutoResizeRows Methode

Definition

Passt die Höhe einiger oder aller Zeilen an den jeweiligen Inhalt an.

Überlädt

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Passt die Höhe der Zeilen im angegebenen Größenmodus an.

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

Passt die Höhe der angegebenen Zeilen im angegebenen Größenänderungsmodus an und berechnet optional die Höhe unter der Annahme, dass die jeweilige Spaltenbreite anschließend angepasst wird.

AutoResizeRows()

Passt die Höhe aller Zeilen an den Inhalt ihrer Zellen einschließlich der Headerzellen an.

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

Passt die Höhe aller Zeilen im angegebenen Größenänderungsmodus an und berechnet optional die jeweilige Höhe unter der Annahme, dass die jeweilige Spaltenbreite anschließend angepasst wird.

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Passt die Höhe der Zeilen im angegebenen Größenmodus an.

public:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode);
public void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode -> unit
Public Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode)

Parameter

Ausnahmen

autoSizeRowsMode hat den Wert AllHeaders oder DisplayedHeaders, und RowHeadersVisible ist false.

autoSizeRowsMode ist kein gültiger DataGridViewAutoSizeRowsMode-Wert.

autoSizeRowsMode hat den Wert None.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Größe aller Zeilen basierend auf zellenfremdem Inhalt geändert wird. Dieses Codebeispiel ist Teil eines größeren Beispiels unter Vorgehensweise: Programmgesteuertes Ändern der Größe von Zellen an Inhalte im Windows Forms DataGridView-Steuerelement.

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann Zeilen ihre Größe ändern. Die Zeilenhöhen werden nur einmal pro Methodenaufruf angepasst. wenn sich der Inhalt der Zeilen später ändert, werden die Zeilen nicht automatisch angepasst. Verwenden Sie die -Methode, um die AutoResizeRow Größe einer bestimmten Zeile zu ändern. Verwenden Sie die Überladung, um die AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) Größe einer Teilmenge von Zeilen zu ändern. Verwenden Sie AutoSizeRowsMode die -Eigenschaft, um die Zeilen so festzulegen, dass sie bei jeder Inhaltsänderung automatisch geändert werden.

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.

Mit dieser Überladung können Sie einen Größenanpassungsmodus angeben, der die neuen Höhen basierend auf Werten in einer begrenzten Gruppe von Zellen berechnet, z. B. nur in angezeigten Zeilen. Dies verbessert die Leistung, wenn das Steuerelement eine große Anzahl von Zeilen enthält.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Größenoptionen im Windows Forms DataGridView-Steuerelements.

Weitere Informationen

Gilt für:

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

Passt die Höhe der angegebenen Zeilen im angegebenen Größenänderungsmodus an und berechnet optional die Höhe unter der Annahme, dass die jeweilige Spaltenbreite anschließend angepasst wird.

protected:
 void AutoResizeRows(int rowIndexStart, int rowsCount, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRows (int rowIndexStart, int rowsCount, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRows : int * int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRows (rowIndexStart As Integer, rowsCount As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Parameter

rowIndexStart
Int32

Der Index der ersten Zeile, deren Größe geändert werden soll.

rowsCount
Int32

Die Anzahl der Zeilen, deren Größe geändert werden soll.

autoSizeRowMode
DataGridViewAutoSizeRowMode

Einer der DataGridViewAutoSizeRowMode-Werte.

fixedWidth
Boolean

true, um die jeweils neue Höhe auf Grundlage der aktuellen Spaltenbreite zu berechnen, false, um die Höhe unter der Annahme zu berechnen, dass die jeweilige Spaltenbreite ebenfalls angepasst wird.

Ausnahmen

autoSizeRowsMode hat den Wert AllHeaders oder DisplayedHeaders, und RowHeadersVisible ist false.

autoSizeRowsMode ist kein gültiger DataGridViewAutoSizeRowsMode-Wert.

autoSizeRowsMode hat den Wert None.

rowIndexStart ist kleiner als 0.

- oder -

rowsCount ist kleiner als 0.

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann Zeilen die Größe ändern, aber nur eine bestimmte Teilmenge von Zeilen ändern möchten, z. B. diejenigen innerhalb eines Bereichs von gebundenen Datensätzen, die aktualisiert wurden. Die Zeilenhöhen für die angegebenen Zeilen werden nur einmal pro Methodenaufruf angepasst. wenn sich der Inhalt der Zeilen später ändert, werden die Zeilen nicht automatisch angepasst. Verwenden Sie die -Methode, um die AutoResizeRow Größe einer bestimmten Zeile zu ändern. Um die Größe aller Zeilen zu ändern, verwenden Sie eine andere Überladung der AutoResizeRows -Methode. Verwenden Sie AutoSizeRowsMode die -Eigenschaft, um die Zeilen so festzulegen, dass sie bei jeder Inhaltsänderung automatisch geändert werden.

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.

Mit dieser Überladung können Sie einen Größenanpassungsmodus angeben, der die neuen Höhen basierend auf Werten in einer begrenzten Gruppe von Zellen berechnet, z. B. nur in angezeigten Zeilen. Dies verbessert die Leistung, wenn das Steuerelement eine große Anzahl von Zeilen enthält.

Diese Überladung ist geschützt und ist so konzipiert, dass Sie in einer abgeleiteten DataGridView Klasse ideale Zellhöhen-Breite-Verhältnisse erzielen können. Wenn der fixedWidth Parameter istfalse, werden die Zeilenhöhen mit der Erwartung berechnet, dass Sie die -Methode oder AutoResizeColumns als AutoResizeColumn Nächstes aufrufen.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Größenoptionen im Windows Forms DataGridView-Steuerelements.

Weitere Informationen

Gilt für:

AutoResizeRows()

Passt die Höhe aller Zeilen an den Inhalt ihrer Zellen einschließlich der Headerzellen an.

public:
 void AutoResizeRows();
public void AutoResizeRows ();
member this.AutoResizeRows : unit -> unit
Public Sub AutoResizeRows ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Größe aller Zeilen basierend auf zellenfremdem Inhalt geändert wird. Dieses Codebeispiel ist Teil eines größeren Beispiels unter Vorgehensweise: Programmgesteuertes Ändern der Größe von Zellen an Inhalte im Windows Forms DataGridView-Steuerelement.

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann Zeilen ihre Größe ändern. Die Zeilenhöhen werden nur einmal pro Methodenaufruf angepasst. wenn sich der Inhalt der Zeilen später ändert, werden die Zeilen nicht automatisch angepasst. Verwenden Sie die -Methode, um die AutoResizeRow Größe einer bestimmten Zeile zu ändern. Verwenden Sie die Überladung, um die AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) Größe einer Teilmenge von Zeilen zu ändern. Verwenden Sie AutoSizeRowsMode die -Eigenschaft, um die Zeilen so festzulegen, dass sie bei jeder Inhaltsänderung automatisch geändert werden.

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 programmgesteuerten Größenänderung finden Sie unter Größenoptionen im Windows Forms DataGridView-Steuerelements.

Weitere Informationen

Gilt für:

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

Passt die Höhe aller Zeilen im angegebenen Größenänderungsmodus an und berechnet optional die jeweilige Höhe unter der Annahme, dass die jeweilige Spaltenbreite anschließend angepasst wird.

protected:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
protected void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode * bool -> unit
Protected Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode, fixedWidth As Boolean)

Parameter

fixedWidth
Boolean

true, um die jeweils neue Höhe auf Grundlage der aktuellen Spaltenbreite zu berechnen, false, um die Höhe unter der Annahme zu berechnen, dass die jeweilige Spaltenbreite ebenfalls angepasst wird.

Ausnahmen

autoSizeRowsMode hat den Wert AllHeaders oder DisplayedHeaders, und RowHeadersVisible ist false.

autoSizeRowsMode ist kein gültiger DataGridViewAutoSizeRowsMode-Wert.

autoSizeRowsMode hat den Wert None.

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann Zeilen ihre Größe ändern. Die Zeilenhöhen werden nur einmal pro Methodenaufruf angepasst. wenn sich der Inhalt der Zeilen später ändert, werden die Zeilen nicht automatisch angepasst. Verwenden Sie die -Methode, um die AutoResizeRow Größe einer bestimmten Zeile zu ändern. Verwenden Sie die Überladung, um die AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) Größe einer Teilmenge von Zeilen zu ändern. Verwenden Sie AutoSizeRowsMode die -Eigenschaft, um die Zeilen so festzulegen, dass sie bei jeder Inhaltsänderung automatisch geändert werden.

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.

Mit dieser Überladung können Sie einen Größenanpassungsmodus angeben, der die neuen Höhen basierend auf Werten in einer begrenzten Gruppe von Zellen berechnet, z. B. nur in angezeigten Zeilen. Dies verbessert die Leistung, wenn das Steuerelement eine große Anzahl von Zeilen enthält.

Diese Überladung ist geschützt und ist so konzipiert, dass Sie in einer abgeleiteten DataGridView Klasse ideale Zellhöhen-Breite-Verhältnisse erzielen können. Wenn der fixedWidth Parameter istfalse, werden die Zeilenhöhen mit der Erwartung berechnet, dass Sie die -Methode oder AutoResizeColumns als AutoResizeColumn Nächstes aufrufen.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Größenoptionen im Windows Forms DataGridView-Steuerelements.

Weitere Informationen

Gilt für: