DataGridView.AutoResizeRows 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
调整某些或所有行的高度以适应其内容。
重载
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
例外
autoSizeRowsMode
具有值 AllHeaders 或 DisplayedHeaders,并且 RowHeadersVisible 为 false
。
autoSizeRowsMode
不是有效的 DataGridViewAutoSizeRowsMode 值。
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
- fixedWidth
- Boolean
如果基于当前的列宽计算新高度,则为 true
;如果在列宽也进行调整的假定条件下计算高度,则为 false
。
例外
autoSizeRowsMode
具有值 AllHeaders 或 DisplayedHeaders,并且 RowHeadersVisible 为 false
。
autoSizeRowsMode
不是有效的 DataGridViewAutoSizeRowsMode 值。
autoSizeRowsMode
具有值 None。
注解
如果要控制何时重设行大小,但只想调整特定行子集的大小(例如已更新的绑定记录范围内的行),此方法非常有用。 每个方法调用仅调整一次指定行的行高;如果行的内容以后发生更改,则行不会自动调整。 若要调整特定行的大小,请使用 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
- fixedWidth
- Boolean
如果基于当前的列宽计算新高度,则为 true
;如果在列宽也进行调整的假定条件下计算高度,则为 false
。
例外
autoSizeRowsMode
具有值 AllHeaders 或 DisplayedHeaders,并且 RowHeadersVisible 为 false
。
autoSizeRowsMode
不是有效的 DataGridViewAutoSizeRowsMode 值。
autoSizeRowsMode
具有值 None。
注解
如果要控制行的大小调整时间,此方法非常有用。 每个方法调用仅调整一次行高;如果行的内容以后发生更改,则行不会自动调整。 若要调整特定行的大小,请使用 AutoResizeRow 方法。 若要重设行子集的大小,请使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 重载。 若要将行设置为在行内容更改时自动调整大小,请使用 AutoSizeRowsMode 属性。
要使单元格内容在调整行大小时换行到多行上,单元格的单元格样式必须具有 WrapMode 属性值 True。
此重载允许你指定一种大小调整模式,该模式基于一组有限单元格中的值(例如仅显示行中的值)计算新高度。 当控件包含大量行时,这可以提高性能。
此重载受到保护,旨在使你能够在派生 DataGridView 类中实现理想的单元格高度与宽度比率。
fixedWidth
如果 参数为 false
,则将计算行高度,并期望接下来调用 AutoResizeColumn 或 AutoResizeColumns 方法。
有关以编程方式调整大小的详细信息,请参阅 Windows 窗体 DataGridView 控件中的调整大小选项。