DataGridView.AutoResizeRow 方法

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

调整指定行的高度以适应其单元格的内容。

重载

AutoResizeRow(Int32)

调整指定行的高度以适应其所有单元格（包括标题单元格）的内容。
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

使用指定的大小调整模式调整指定行的高度。
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

使用指定的大小调整模式调整指定行的高度，还可以选择在列宽随后进行调整的假定条件下计算高度。

AutoResizeRow(Int32)

调整指定行的高度以适应其所有单元格（包括标题单元格）的内容。

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

参数

rowIndex
Int32

要调整大小的行的索引。

例外

ArgumentOutOfRangeException

rowIndex 不在 0 到行数减 1 的有效范围内。

示例

下面的代码示例调整 中的 DataGridView 第三行的大小以适应列内容。 此代码示例是如何：以编程方式调整单元格大小以适应 Windows 窗体 DataGridView 控件中的内容中提供的更大示例的一部分。

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

注解

如果要控制行的大小调整时间，此方法非常有用。 每个方法调用仅调整行高一次;如果行的内容稍后发生更改，则行不会自动调整。 若要调整所有行的大小，请使用 AutoResizeRows 方法。 若要将行设置为在内容发生更改时自动调整其大小，请使用 AutoSizeRowsMode 属性。

若要在调整行大小时将单元格内容换行到多行上，对单元格生效的单元格样式的属性值True必须为 WrapMode 。

有关以编程方式调整大小的详细信息，请参阅 Windows 窗体 DataGridView 控件中的调整大小选项。

另请参阅

适用于

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

使用指定的大小调整模式调整指定行的高度。

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)

参数

rowIndex
Int32

要调整大小的行的索引。

autoSizeRowMode
DataGridViewAutoSizeRowMode

DataGridViewAutoSizeRowMode 值之一。

例外

InvalidOperationException

autoSizeRowMode 具有值 RowHeader，且 RowHeadersVisible 为 false。

InvalidEnumArgumentException

autoSizeRowMode 不是有效的 DataGridViewAutoSizeRowMode 值。

ArgumentOutOfRangeException

rowIndex 不在 0 到行数减 1 的有效范围内。

示例

下面的代码示例调整 中的 DataGridView 第三行的大小以适应列内容。 此代码示例是如何：以编程方式调整单元格大小以适应 Windows 窗体 DataGridView 控件中的内容中提供的更大示例的一部分。

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

注解

如果要控制行的大小调整时间，此方法非常有用。 每个方法调用仅调整行高一次;如果行的内容稍后发生更改，则行不会自动调整。 若要调整所有行的大小，请使用 AutoResizeRows 方法。 若要将行设置为在内容发生更改时自动调整其大小，请使用 AutoSizeRowsMode 属性。

若要在调整行大小时将单元格内容换行到多行上，对单元格生效的单元格样式的属性值True必须为 WrapMode 。

此重载允许指定大小调整模式，该模式根据一组有限的单元格（例如仅显示行中的单元格）中的值计算新高度。 当控件包含大量行时，这可以提高性能。

有关以编程方式调整大小的详细信息，请参阅 Windows 窗体 DataGridView 控件中的调整大小选项。

另请参阅

适用于

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

使用指定的大小调整模式调整指定行的高度，还可以选择在列宽随后进行调整的假定条件下计算高度。

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)

参数

rowIndex
Int32

要调整大小的行的索引。

autoSizeRowMode
DataGridViewAutoSizeRowMode

DataGridViewAutoSizeRowMode 值之一。

fixedWidth
Boolean

如果要基于列的当前宽度计算新高度，则为 true；如果要在列宽也进行调整的假定条件下计算高度，则为 false。

例外

InvalidOperationException

autoSizeRowMode 具有值 RowHeader，且 RowHeadersVisible 为 false。

InvalidEnumArgumentException

autoSizeRowMode 不是有效的 DataGridViewAutoSizeRowMode 值。

ArgumentOutOfRangeException

rowIndex 不在 0 到行数减 1 的有效范围内。

注解

如果要控制行的大小调整时间，此方法非常有用。 每个方法调用仅调整行高一次;如果行的内容稍后发生更改，则行不会自动调整。 若要调整所有行的大小，请使用 AutoResizeRows 方法。 若要将行设置为在内容发生更改时自动调整其大小，请使用 AutoSizeRowsMode 属性。

若要在调整行大小时将单元格内容换行到多行上，对单元格生效的单元格样式的属性值True必须为 WrapMode 。

此重载允许指定大小调整模式，该模式根据一组有限的单元格（例如仅显示行中的单元格）中的值计算新高度。 当控件包含大量行时，这可以提高性能。

此重载受到保护，旨在使你能够在派生 DataGridView 类中实现理想的单元格高度与宽度比率。 如果 fixedWidth 为 false，则将根据你接下来调用 AutoResizeColumn 或 AutoResizeColumns 方法的预期来计算行高。

有关以编程方式调整大小的详细信息，请参阅 Windows 窗体 DataGridView 控件中的调整大小选项。

另请参阅

适用于