DataGridView.AutoResizeRowHeadersWidth 方法

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

调整行标题的宽度以适应标题内容。

重载

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)	使用指定的大小调整模式调整行标题的宽度。
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)	使用指定的大小调整模式，基于指定行中标题内容的更改调整行标题的宽度。
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)	使用指定的大小调整模式调整行标题的宽度，还可以选择在行和/或列标题的高度随后进行调整的假定条件下计算宽度。
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)	使用指定的大小调整模式基于指定行中标题内容的更改来调整行标题的宽度，还可以选择在列和/或行标题的高度随后进行调整的假定条件下计算宽度。

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

使用指定的大小调整模式调整行标题的宽度。

public:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);

public void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);

member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit

Public Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

参数

rowHeadersWidthSizeMode: DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 值之一。

例外

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing。

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

注解

如果要控制行标题大小调整时间，此方法非常有用。每方法调用仅调整一次行标题的宽度;如果行标题的内容稍后发生更改，则行标题不会自动调整。若要设置行标题以在内容更改时自动调整大小，请使用 RowHeadersWidthSizeMode 该属性。

使用此方法可以指定一种大小调整模式，该模式基于一组有限标头中的值（如仅显示行中的值）计算新宽度。当控件包含大量行时，这会提高性能。

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

另请参阅

DataGridView 控件（Windows 窗体）

适用于

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

使用指定的大小调整模式，基于指定行中标题内容的更改调整行标题的宽度。

public:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);

public void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);

member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit

Public Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

参数

rowIndex: Int32

内容已更改的行标题的索引。

rowHeadersWidthSizeMode: DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 值之一。

例外

ArgumentOutOfRangeException

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

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

示例

下面的代码示例演示如何根据对第一行标题内容的更改调整行标题宽度的大小。此代码示例是 How to：以编程方式调整单元格大小以适应 Windows 窗体 DataGridView 控件中内容的大型示例的一部分。

void SizeFirstRowHeaderToAllHeaders( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRowHeadersWidth(0, DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders);
}

private void SizeFirstRowHeaderToAllHeaders(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRowHeadersWidth(
        0, DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}

Private Sub SizeFirstRowHeaderToAllHeaders(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    DataGridView1.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)

End Sub

注解

如果要控制当指定行中标头的内容因用户编辑或更改绑定到数据源而更改时，行标题的大小调整时，此方法非常有用。如果内容更改需要它，则行标题的宽度仅在每个方法调用中调整一次;如果行标题的内容稍后发生更改，则行标题不会自动调整。若要设置行标题以在内容更改时自动调整大小，请使用 RowHeadersWidthSizeMode 该属性。

使用此方法可以指定一种大小调整模式，该模式基于一组有限标头中的值（如仅显示行中的值）计算新宽度。当控件包含大量行时，这会提高性能。

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

另请参阅

DataGridView 控件（Windows 窗体）

适用于

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

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

protected:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);

protected void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);

member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit

Protected Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowsHeight As Boolean)

参数

rowHeadersWidthSizeMode: DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 值之一。

fixedColumnHeadersHeight: Boolean

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

fixedRowsHeight: Boolean

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

例外

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing。

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

注解

使用此方法可以指定一种大小调整模式，该模式基于一组有限标头中的值（如仅显示行中的值）计算新宽度。当控件包含大量行时，这会提高性能。

此重载受到保护，旨在使你能够在派生 DataGridView 类中实现理想的单元格高度与宽度比率。 fixedColumnHeadersHeight如果为或fixedRowsHeight参数false，将计算行标题的宽度，并期望调用方法，例如AutoResizeRows和AutoResizeColumnHeadersHeight下一步。

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

另请参阅

DataGridView 控件（Windows 窗体）

适用于

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

使用指定的大小调整模式基于指定行中标题内容的更改来调整行标题的宽度，还可以选择在列和/或行标题的高度随后进行调整的假定条件下计算宽度。

protected:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);

protected void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);

member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit

Protected Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowHeight As Boolean)

参数

rowIndex: Int32

某一行的索引，该行包含内容已更改的标题。

rowHeadersWidthSizeMode: DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 值之一。

fixedColumnHeadersHeight: Boolean

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

fixedRowHeight: Boolean

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

例外

ArgumentOutOfRangeException

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

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing。

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

注解

使用此方法可以指定一种大小调整模式，该模式基于一组有限标头中的值（如仅显示行中的值）计算新宽度。当控件包含大量行时，这会提高性能。

此重载受到保护，旨在使你能够在派生 DataGridView 类中实现理想的单元格高度与宽度比率。 fixedColumnHeadersHeight如果为或fixedRowHeight参数false，将计算行标题的宽度，并期望调用方法，例如AutoResizeRows和AutoResizeColumnHeadersHeight下一步。

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

另请参阅

DataGridView 控件（Windows 窗体）

适用于

DataGridView.AutoResizeRowHeadersWidth 方法

定义

重载

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

参数

例外

注解

另请参阅

适用于

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

参数

例外

示例

注解

另请参阅

适用于

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

参数

例外

注解

另请参阅

适用于

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

参数

例外

注解

另请参阅

适用于

其他资源