DataGridView.AutoResizeRows Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- autoSizeRowsMode
- DataGridViewAutoSizeRowsMode
Einer der DataGridViewAutoSizeRowsMode-Werte.
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.
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
- autoSizeRowsMode
- DataGridViewAutoSizeRowsMode
Einer der DataGridViewAutoSizeRowsMode-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.
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.