DataGridView.AutoResizeRows 方法

  • 参考

定义

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

调整某些或所有行的高度以适应其内容。

重载

AutoResizeRows(DataGridViewAutoSizeRowsMode)

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

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

调整所有行的高度以适应其所有单元格（包括标题单元格）的内容。
AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

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

AutoResizeRows(DataGridViewAutoSizeRowsMode)

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

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)

参数

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

DataGridViewAutoSizeRowsMode 值之一。

例外

InvalidOperationException

autoSizeRowsMode 具有值 AllHeaders 或 DisplayedHeaders，并且 RowHeadersVisible 为 false。

InvalidEnumArgumentException

autoSizeRowsMode 不是有效的 DataGridViewAutoSizeRowsMode 值。

ArgumentException

autoSizeRowsMode 具有值 None。

示例

下面的代码示例演示如何根据非标题单元格内容调整所有行的大小。 此代码示例是如何：以编程方式调整单元格大小以适应 DataGridView 控件中的内容Windows 窗体中提供的更大示例的一部分。

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

注解

如果要控制行的大小调整时间，此方法非常有用。 每个方法调用仅调整一次行高;如果行的内容以后发生更改，则行不会自动调整。 若要调整特定行的大小，请使用 AutoResizeRow 方法。 若要重设行子集的大小，请使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 重载。 若要将行设置为在行内容更改时自动调整大小，请使用 AutoSizeRowsMode 属性。

要使单元格内容在调整行大小时换行到多行上，单元格的单元格样式必须具有 WrapMode 属性值 True。

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

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

另请参阅

适用于

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

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

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)

参数

rowIndexStart
Int32

要调整大小的第一行的索引。

rowsCount
Int32

要调整大小的行数。

autoSizeRowMode
DataGridViewAutoSizeRowMode

DataGridViewAutoSizeRowMode 值之一。

fixedWidth
Boolean

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

例外

InvalidOperationException

autoSizeRowsMode 具有值 AllHeaders 或 DisplayedHeaders，并且 RowHeadersVisible 为 false。

InvalidEnumArgumentException

autoSizeRowsMode 不是有效的 DataGridViewAutoSizeRowsMode 值。

ArgumentException

autoSizeRowsMode 具有值 None。

ArgumentOutOfRangeException

rowIndexStart 小于 0。

- 或 -

rowsCount 小于 0。

注解

如果要控制何时重设行大小，但只想调整特定行子集的大小（例如已更新的绑定记录范围内的行），此方法非常有用。 每个方法调用仅调整一次指定行的行高;如果行的内容以后发生更改，则行不会自动调整。 若要调整特定行的大小，请使用 AutoResizeRow 方法。 若要重设所有行的大小，请使用 方法的不同重载 AutoResizeRows 。 若要将行设置为在行内容更改时自动调整大小，请使用 AutoSizeRowsMode 属性。

要使单元格内容在调整行大小时换行到多行上，单元格的单元格样式必须具有 WrapMode 属性值 True。

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

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

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

另请参阅

适用于

AutoResizeRows()

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

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

示例

下面的代码示例演示如何根据非标题单元格内容调整所有行的大小。 此代码示例是如何：以编程方式调整单元格大小以适应 DataGridView 控件中的内容Windows 窗体中提供的更大示例的一部分。

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

注解

如果要控制行的大小调整时间，此方法非常有用。 每个方法调用仅调整一次行高;如果行的内容以后发生更改，则行不会自动调整。 若要调整特定行的大小，请使用 AutoResizeRow 方法。 若要重设行子集的大小，请使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 重载。 若要将行设置为在行内容更改时自动调整大小，请使用 AutoSizeRowsMode 属性。

要使单元格内容在调整行大小时换行到多行上，单元格的单元格样式必须具有 WrapMode 属性值 True。

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

另请参阅

适用于

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

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

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)

参数

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

DataGridViewAutoSizeRowsMode 值之一。

fixedWidth
Boolean

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

例外

InvalidOperationException

autoSizeRowsMode 具有值 AllHeaders 或 DisplayedHeaders，并且 RowHeadersVisible 为 false。

InvalidEnumArgumentException

autoSizeRowsMode 不是有效的 DataGridViewAutoSizeRowsMode 值。

ArgumentException

autoSizeRowsMode 具有值 None。

注解

如果要控制行的大小调整时间，此方法非常有用。 每个方法调用仅调整一次行高;如果行的内容以后发生更改，则行不会自动调整。 若要调整特定行的大小，请使用 AutoResizeRow 方法。 若要重设行子集的大小，请使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 重载。 若要将行设置为在行内容更改时自动调整大小，请使用 AutoSizeRowsMode 属性。

要使单元格内容在调整行大小时换行到多行上，单元格的单元格样式必须具有 WrapMode 属性值 True。

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

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

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

另请参阅

适用于