DataGridView.AutoResizeColumns 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
调整所有列的宽度以适应其单元格的内容。
重载
AutoResizeColumns() |
调整所有列的宽度以适应其所有单元格(包括标题单元格)的内容。 |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode) |
使用指定的大小调整模式调整所有列的宽度。 |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean) |
使用指定的大小调整模式调整所有列的宽度,还可以选择在行高随后进行调整的假定条件下计算宽度。 |
AutoResizeColumns()
调整所有列的宽度以适应其所有单元格(包括标题单元格)的内容。
public:
void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()
示例
下面的代码示例调整所有列的大小以适应列和列标题的内容。 此代码示例是 How to: 以编程方式调整单元格大小以适应 Windows 窗体 DataGridView 控件中内容的大型示例的一部分。
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
注解
如果要控制列大小调整时,此方法非常有用。 每个方法调用仅调整一次列宽;如果列的内容稍后发生更改,则列不会自动调整。 若要调整特定列的大小,请使用 AutoResizeColumn 该方法。 若要设置列以在内容发生更改时自动调整大小,请使用 AutoSizeColumnsMode 属性或列 AutoSizeMode 属性。
有关编程大小调整的详细信息,请参阅 Windows 窗体 dataGridView 控件中的大小调整选项。
另请参阅
适用于
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)
使用指定的大小调整模式调整所有列的宽度。
public:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)
参数
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
例外
autoSizeColumnsMode
具有值 ColumnHeader,且 ColumnHeadersVisible 为 false
。
autoSizeColumnsMode
不是有效的 DataGridViewAutoSizeColumnsMode 值。
示例
下面的代码示例调整所有列的大小以适应列和列标题的内容。 此代码示例是 How to: 以编程方式调整单元格大小以适应 Windows 窗体 DataGridView 控件中内容的大型示例的一部分。
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
注解
如果要控制列大小调整时,此方法非常有用。 每个方法调用仅调整一次列宽;如果列的内容稍后发生更改,则列不会自动调整。 若要调整特定列的大小,请使用 AutoResizeColumn 该方法。 若要设置列以在内容发生更改时自动调整大小,请使用 AutoSizeColumnsMode 属性或列 AutoSizeMode 属性。
通过此重载,可以指定一种大小调整模式,该模式根据一组有限单元格中的值(例如仅显示行中的值)计算新宽度。 当控件包含大量行时,这会提高性能。
有关编程大小调整的详细信息,请参阅 Windows 窗体 dataGridView 控件中的大小调整选项。
另请参阅
适用于
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)
使用指定的大小调整模式调整所有列的宽度,还可以选择在行高随后进行调整的假定条件下计算宽度。
protected:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)
参数
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
- fixedHeight
- Boolean
如果要基于当前的行高计算新宽度,则为 true
;如果要在行高也进行调整的假定条件下计算宽度,则为 false
。
例外
autoSizeColumnsMode
具有值 ColumnHeader,且 ColumnHeadersVisible 为 false
。
autoSizeColumnsMode
不是有效的 DataGridViewAutoSizeColumnsMode 值。
注解
如果要控制列大小调整时,此方法非常有用。 每个方法调用仅调整一次列宽;如果列的内容稍后发生更改,则列不会自动调整。 若要调整特定列的大小,请使用 AutoResizeColumn 该方法。 若要设置列以在内容发生更改时自动调整大小,请使用 AutoSizeColumnsMode 属性或列 AutoSizeMode 属性。
通过此重载,可以指定一种大小调整模式,该模式根据一组有限单元格中的值(例如仅显示行中的值)计算新宽度。 当控件包含大量行时,这会提高性能。
此重载受到保护,旨在使你能够在派生 DataGridView 类中实现理想的单元格高度与宽度比率。 false
如果是fixedHeight
,将计算列宽,并期望接下来调用AutoResizeRow或AutoResizeRows方法。
有关编程大小调整的详细信息,请参阅 Windows 窗体 dataGridView 控件中的大小调整选项。