DataGridViewColumn.AutoSizeMode 属性

  • 参考

定义

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

获取或设置模式，通过此模式列可以自动调整其宽度。

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }
member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set
Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

属性值

DataGridViewAutoSizeColumnMode

DataGridViewAutoSizeColumnMode 值确定该列是否将自动调整其宽度，以及该列将如何确定首选宽度。 默认值为 NotSet。

例外

InvalidEnumArgumentException

设置此属性时，指定的值为无效的 DataGridViewAutoSizeColumnMode。

InvalidOperationException

设置此属性时，如果列标题被隐藏，指定的值会导致可视列的 InheritedAutoSizeMode 为 ColumnHeader 值。

- 或 -

设置此属性时，指定的值会导致冻结的可视列的 InheritedAutoSizeMode 为 Fill 值。

示例

下面的代码示例强制列自动调整其宽度以适应其内容。 此代码示例是为 DataGridViewColumn 类提供的一个更大示例的一部分。

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

注解

列的自动大小调整行为由 属性的值 InheritedAutoSizeMode 决定，该值与 AutoSizeMode 除 之外 NotSet的所有值的 属性值相同，该值指示该值改为继承自 DataGridView.AutoSizeColumnsMode 属性。

当 InheritedAutoSizeMode 属性值为 Fill时，该列将连同该模式下的其他列一起调整大小。 控件中的所有填充模式列按属性值 FillWeight 确定的比例将可用空间除以。 可用于填充模式的宽度是通过从控件工作区的宽度中减去所有其他列的宽度来确定的。 如果此宽度小于所有填充模式列的组合 MinimumWidth 值，则显示水平滚动条，显示所有填充模式列的最小宽度，并禁用用户列大小调整。 有关列填充模式的详细信息，请参阅 Windows 窗体 DataGridView 控件中的列填充模式。

当 属性 InheritedAutoSizeMode 设置为 除 之外 None的任何其他值时，列将管理其宽度，以便完全显示其单元格值，而不会进行剪切。 在基于内容的大小调整模式下，每当单元格内容发生更改时， WrapMode 或如果启用，则每当行高更改时，都进行大小调整。 某些基于内容的大小调整模式允许将大小调整限制为当前显示的行，以提高性能。

仅调整属性值为 的true列Visible的大小，更改列的可见性不会导致调整大小。 此外，当列设置为自动调整大小时，用户无法使用鼠标调整列宽。

若要以编程方式调整列宽，请使用 DataGridView 控件的 AutoResizeColumn 或 AutoResizeColumns 方法或设置列 Width 属性。

有关基于内容的自动大小调整的详细信息，请参阅 Windows 窗体 DataGridView 控件中的调整大小选项。

适用于

另请参阅