DataGridView.AutoResizeRow 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 der angegebenen Zeile an den Inhalt ihrer Zellen an.
Überlädt
| AutoResizeRow(Int32) |
Passt die Höhe der angegebenen Zeile an den Inhalt ihrer Zellen einschließlich der Headerzelle an. |
| AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) |
Passt die Höhe der angegebenen Zeile anhand des angegebenen Größenmodus an. |
| AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) |
Passt die Höhe der angegebenen Zeile im angegebenen Größenänderungsmodus an und berechnet optional die Höhe unter der Annahme, dass die jeweilige Spaltenbreite anschließend angepasst wird. |
AutoResizeRow(Int32)
Passt die Höhe der angegebenen Zeile an den Inhalt ihrer Zellen einschließlich der Headerzelle an.
public:
void AutoResizeRow(int rowIndex);public void AutoResizeRow (int rowIndex);member this.AutoResizeRow : int -> unitPublic Sub AutoResizeRow (rowIndex As Integer)Parameter
- rowIndex
- Int32
Der Index der Zeile, deren Größe geändert werden soll.
Ausnahmen
rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.
Beispiele
Im folgenden Codebeispiel wird die Größe der dritten Zeile in einem DataGridView an den Spalteninhalt angepasst. Dieses Codebeispiel ist Teil eines größeren Beispiels unter Vorgehensweise: Programmgesteuertes Ändern der Größe von Zellen zum Anpassen von Inhalten im Windows Forms DataGridView-Steuerelement.
void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
dataGridView1.AutoResizeRow(
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button7.Click
Dim thirdRow As Integer = 2
DataGridView1.AutoResizeRow( _
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)
End Sub
Hinweise
Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Größe einer Zeile geändert wird. Die Zeilenhöhe wird nur einmal pro Methodenaufruf angepasst. Wenn sich der Inhalt der Zeile später ändert, wird die Zeile nicht automatisch angepasst. Verwenden Sie die -Methode, um die AutoResizeRows Größe aller Zeilen zu ändern. Verwenden Sie die -Eigenschaft, um festzulegen, dass die Größe der AutoSizeRowsMode Zeile bei jeder Inhaltsänderung automatisch geändert wird.
Damit Zellinhalte in mehrere Zeilen umgebrochen werden können, wenn die Größe einer Zeile geändert wird, muss das für die Zelle wirkende Zellenformat den WrapMode -Eigenschaftswert aufweisen True.
Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Größenanpassungsoptionen im Windows Forms DataGridView-Steuerelement.
Weitere Informationen
Gilt für:
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)
Passt die Höhe der angegebenen Zeile anhand des angegebenen Größenmodus an.
public:
void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode);public void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode);member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode -> unitPublic Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode)Parameter
- rowIndex
- Int32
Der Index der Zeile, deren Größe geändert werden soll.
- autoSizeRowMode
- DataGridViewAutoSizeRowMode
Einer der DataGridViewAutoSizeRowMode-Werte.
Ausnahmen
autoSizeRowMode hat den Wert RowHeader, und RowHeadersVisible ist false.
autoSizeRowMode ist kein gültiger DataGridViewAutoSizeRowMode-Wert.
rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.
Beispiele
Im folgenden Codebeispiel wird die Größe der dritten Zeile in einem DataGridView an den Spalteninhalt angepasst. Dieses Codebeispiel ist Teil eines größeren Beispiels unter Vorgehensweise: Programmgesteuertes Ändern der Größe von Zellen zum Anpassen von Inhalten im Windows Forms DataGridView-Steuerelement.
void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
dataGridView1.AutoResizeRow(
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button7.Click
Dim thirdRow As Integer = 2
DataGridView1.AutoResizeRow( _
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)
End Sub
Hinweise
Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Größe einer Zeile geändert wird. Die Zeilenhöhe wird nur einmal pro Methodenaufruf angepasst. Wenn sich der Inhalt der Zeile später ändert, wird die Zeile nicht automatisch angepasst. Verwenden Sie die -Methode, um die AutoResizeRows Größe aller Zeilen zu ändern. Verwenden Sie die -Eigenschaft, um festzulegen, dass die Größe der AutoSizeRowsMode Zeile bei jeder Inhaltsänderung automatisch geändert wird.
Damit Zellinhalte in mehrere Zeilen umgebrochen werden können, wenn die Größe einer Zeile geändert wird, muss das für die Zelle wirkende Zellenformat den WrapMode -Eigenschaftswert aufweisen True.
Mit dieser Überladung können Sie einen Größenanpassungsmodus angeben, der die neue Höhe 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ößenanpassungsoptionen im Windows Forms DataGridView-Steuerelement.
Weitere Informationen
Gilt für:
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)
Passt die Höhe der angegebenen Zeile 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 AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);protected void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unitProtected Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)Parameter
- rowIndex
- Int32
Der Index der Zeile, deren Größe geändert werden soll.
- autoSizeRowMode
- DataGridViewAutoSizeRowMode
Einer der DataGridViewAutoSizeRowMode-Werte.
- fixedWidth
- Boolean
true, um die neue Höhe auf Grundlage der aktuellen Breite der Spalten zu berechnen, false, um die Höhe unter der Annahme zu berechnen, dass die jeweilige Spaltenbreite ebenfalls angepasst wird.
Ausnahmen
autoSizeRowMode hat den Wert RowHeader, und RowHeadersVisible ist false.
autoSizeRowMode ist kein gültiger DataGridViewAutoSizeRowMode-Wert.
rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.
Hinweise
Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Größe einer Zeile geändert wird. Die Zeilenhöhe wird nur einmal pro Methodenaufruf angepasst. Wenn sich der Inhalt der Zeile später ändert, wird die Zeile nicht automatisch angepasst. Verwenden Sie die -Methode, um die AutoResizeRows Größe aller Zeilen zu ändern. Verwenden Sie die -Eigenschaft, um festzulegen, dass die Größe der AutoSizeRowsMode Zeile bei jeder Inhaltsänderung automatisch geändert wird.
Damit Zellinhalte in mehrere Zeilen umgebrochen werden können, wenn die Größe einer Zeile geändert wird, muss das für die Zelle wirkende Zellenformat den WrapMode -Eigenschaftswert aufweisen True.
Mit dieser Überladung können Sie einen Größenanpassungsmodus angeben, der die neue Höhe 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 Zellenhöhen-Breite-Verhältnisse erzielen können. Wenn fixedWidth istfalse, wird die Zeilenhöhe mit der Erwartung berechnet, dass Sie die - oder AutoResizeColumns -AutoResizeColumnMethode als Nächstes aufrufen.
Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Größenanpassungsoptionen im Windows Forms DataGridView-Steuerelement.
Weitere Informationen
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für