DataGridView.AutoResizeRow DataGridView.AutoResizeRow DataGridView.AutoResizeRow DataGridView.AutoResizeRow Method

Definition

Passt die Höhe der angegebenen Zeile an den Inhalt ihrer Zellen an.Adjusts the height of the specified row to fit the contents of its cells.

Überlädt

AutoResizeRow(Int32) AutoResizeRow(Int32) AutoResizeRow(Int32) AutoResizeRow(Int32)

Passt die Höhe der angegebenen Zeile an den Inhalt ihrer Zellen einschließlich der Headerzelle an.Adjusts the height of the specified row to fit the contents of all its cells including the header cell.

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Passt die Höhe der angegebenen Zeile anhand des angegebenen Größenmodus an.Adjusts the height of the specified row using the specified size mode.

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) 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.Adjusts the height of the specified row using the specified size mode, optionally calculating the height with the expectation that column widths will subsequently be adjusted.

AutoResizeRow(Int32) AutoResizeRow(Int32) AutoResizeRow(Int32) AutoResizeRow(Int32)

Passt die Höhe der angegebenen Zeile an den Inhalt ihrer Zellen einschließlich der Headerzelle an.Adjusts the height of the specified row to fit the contents of all its cells including the header cell.

public:
 void AutoResizeRow(int rowIndex);
public void AutoResizeRow (int rowIndex);
member this.AutoResizeRow : int -> unit
Public Sub AutoResizeRow (rowIndex As Integer)

Parameter

rowIndex
Int32 Int32 Int32 Int32

Der Index der Zeile, deren Größe geändert werden soll.The index of the row to resize.

Ausnahmen

rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

Beispiele

Im folgenden Codebeispiel wird die Größe der dritten Zeile eines DataGridView an den Spalten Inhalt angepasst.The following code example resizes the third row in a DataGridView to fit the column contents. Dieses Codebeispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Programm gesteuertes Anpassen der Zellen Größe an den Inhalt im Windows Forms DataGridView-Steuerelement.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

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.This method is useful if you want to control when a row resizes. Die Zeilenhöhe wird nur einmal pro Methodenaufrufe angepasst. Wenn sich der Inhalt der Zeile später ändert, wird die Zeile nicht automatisch angepasst.The row height is adjusted only once per method call; if the contents of the row later change, the row will not automatically adjust. Verwenden Sie die-Methode, um die AutoResizeRows Größe aller Zeilen zu ändern.To resize all rows, use the AutoResizeRows method. Verwenden Sie die AutoSizeRowsMode -Eigenschaft, um festzulegen, dass die Größe automatisch geändert wird, wenn sich der Inhalt ändert.To set the row to automatically resize whenever its contents change, use the AutoSizeRowsMode 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 TrueWert aufweisen.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 programmatischen Größenänderung finden Sie unter Größen Anpassungsoptionen im Windows Forms DataGridView-SteuerElement.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Siehe auch

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Passt die Höhe der angegebenen Zeile anhand des angegebenen Größenmodus an.Adjusts the height of the specified row using the specified size mode.

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 -> unit
Public Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode)

Parameter

rowIndex
Int32 Int32 Int32 Int32

Der Index der Zeile, deren Größe geändert werden soll.The index of the row to resize.

Ausnahmen

rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

Beispiele

Im folgenden Codebeispiel wird die Größe der dritten Zeile eines DataGridView an den Spalten Inhalt angepasst.The following code example resizes the third row in a DataGridView to fit the column contents. Dieses Codebeispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Programm gesteuertes Anpassen der Zellen Größe an den Inhalt im Windows Forms DataGridView-Steuerelement.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

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.This method is useful if you want to control when a row resizes. Die Zeilenhöhe wird nur einmal pro Methodenaufrufe angepasst. Wenn sich der Inhalt der Zeile später ändert, wird die Zeile nicht automatisch angepasst.The row height is adjusted only once per method call; if the contents of the row later change, the row will not automatically adjust. Verwenden Sie die-Methode, um die AutoResizeRows Größe aller Zeilen zu ändern.To resize all rows, use the AutoResizeRows method. Verwenden Sie die AutoSizeRowsMode -Eigenschaft, um festzulegen, dass die Größe automatisch geändert wird, wenn sich der Inhalt ändert.To set the row to automatically resize whenever its contents change, use the AutoSizeRowsMode 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 TrueWert aufweisen.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.

Mit dieser Überladung können Sie einen Größen Anpassungsmodus angeben, der die neue Höhe auf der Grundlage von Werten in einer begrenzten Menge von Zellen berechnet, z. b. in den angezeigten Zeilen.This overload lets you specify a sizing mode that calculates the new height based on values in a limited set of cells, such as those in displayed rows only. Dadurch wird die Leistung verbessert, wenn das Steuerelement eine große Anzahl von Zeilen enthält.This improves performance when the control contains a large number of rows.

Weitere Informationen zur programmatischen Größenänderung finden Sie unter Größen Anpassungsoptionen im Windows Forms DataGridView-SteuerElement.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Siehe auch

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) 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.Adjusts the height of the specified row using the specified size mode, optionally calculating the height with the expectation that column widths will subsequently be adjusted.

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 -> unit
Protected Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Parameter

rowIndex
Int32 Int32 Int32 Int32

Der Index der Zeile, deren Größe geändert werden soll.The index of the row to resize.

fixedWidth
Boolean Boolean Boolean 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.true to calculate the new height based on the current width of the columns; false to calculate the height with the expectation that the column widths will also be adjusted.

Ausnahmen

rowIndex liegt nicht im gültigen Bereich von 0 bis zur Anzahl der Zeilen minus 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann die Größe einer Zeile geändert wird.This method is useful if you want to control when a row resizes. Die Zeilenhöhe wird nur einmal pro Methodenaufrufe angepasst. Wenn sich der Inhalt der Zeile später ändert, wird die Zeile nicht automatisch angepasst.The row height is adjusted only once per method call; if the contents of the row later change, the row will not automatically adjust. Verwenden Sie die-Methode, um die AutoResizeRows Größe aller Zeilen zu ändern.To resize all rows, use the AutoResizeRows method. Verwenden Sie die AutoSizeRowsMode -Eigenschaft, um festzulegen, dass die Größe automatisch geändert wird, wenn sich der Inhalt ändert.To set the row to automatically resize whenever its contents change, use the AutoSizeRowsMode 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 TrueWert aufweisen.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.

Mit dieser Überladung können Sie einen Größen Anpassungsmodus angeben, der die neue Höhe auf der Grundlage von Werten in einer begrenzten Menge von Zellen berechnet, z. b. in den angezeigten Zeilen.This overload lets you specify a sizing mode that calculates the new height based on values in a limited set of cells, such as those in displayed rows only. Dadurch wird die Leistung verbessert, wenn das Steuerelement eine große Anzahl von Zeilen enthält.This improves performance when the control contains a large number of rows.

Diese Überladung ist geschützt und soll es Ihnen ermöglichen, in einer abgeleiteten DataGridView Klasse eine ideale Größe für die Höhe von Zellen zu erzielen.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. fixedWidth AutoResizeColumn Wenn den Wert AutoResizeColumns hat, wird die Zeilenhöhe mit der Annahme berechnet, dass Sie die-Methode oder die-Methode als nächstes aufzurufen. falseIf fixedWidth is false, the row height will be calculated with the expectation that you will call the AutoResizeColumn or AutoResizeColumns method next.

Weitere Informationen zur programmatischen Größenänderung finden Sie unter Größen Anpassungsoptionen im Windows Forms DataGridView-SteuerElement.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Siehe auch

Gilt für: