DataGridView.AutoResizeColumns 方法

  • 参考

定义

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

调整所有列的宽度以适应其单元格的内容。

重载

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

DataGridViewAutoSizeColumnsMode 值之一。

例外

InvalidOperationException

autoSizeColumnsMode 具有值 ColumnHeader，且 ColumnHeadersVisible 为 false。

ArgumentException

autoSizeColumnsMode 具有值 None 或 Fill。

InvalidEnumArgumentException

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

DataGridViewAutoSizeColumnsMode 值之一。

fixedHeight
Boolean

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

例外

InvalidOperationException

autoSizeColumnsMode 具有值 ColumnHeader，且 ColumnHeadersVisible 为 false。

ArgumentException

autoSizeColumnsMode 具有值 None 或 Fill。

InvalidEnumArgumentException

autoSizeColumnsMode 不是有效的 DataGridViewAutoSizeColumnsMode 值。

注解

如果要控制列大小调整时，此方法非常有用。 每个方法调用仅调整一次列宽;如果列的内容稍后发生更改，则列不会自动调整。 若要调整特定列的大小，请使用 AutoResizeColumn 该方法。 若要设置列以在内容发生更改时自动调整大小，请使用 AutoSizeColumnsMode 属性或列 AutoSizeMode 属性。

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

此重载受到保护，旨在使你能够在派生 DataGridView 类中实现理想的单元格高度与宽度比率。 false如果是fixedHeight，将计算列宽，并期望接下来调用AutoResizeRow或AutoResizeRows方法。

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

另请参阅

适用于