DataGridViewAutoSizeColumnMode 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
定义用于指定如何调整列宽的值。
public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode =
Public Enum DataGridViewAutoSizeColumnMode
- 继承
字段
AllCells | 6 | 调整列宽,以适合该列中的所有单元格的内容,包括标题单元格。 |
AllCellsExceptHeader | 4 | 调整列宽,以适合该列中的所有单元格的内容,不包括标题单元格。 |
ColumnHeader | 2 | 调整列宽,以适合列标题单元格的内容。 |
DisplayedCells | 10 | 调整列宽,以适合当前屏幕上显示的行的列中的所有单元格的内容,包括标题单元格。 |
DisplayedCellsExceptHeader | 8 | 调整列宽,以适合当前屏幕上显示的行的列中的所有单元格的内容,不包括标题单元格。 |
Fill | 16 | 调整列宽,使所有列的宽度正好填充控件的显示区域,只需要水平滚动保证列宽在 MinimumWidth 属性值以上。 相对列宽由相对 FillWeight 属性值决定。 |
None | 1 | 列宽不会自动调整。 |
NotSet | 0 | 列的大小调整行为从 AutoSizeColumnsMode 属性继承。 |
示例
下面的代码示例演示如何使用此枚举来配置固定宽度列。 此示例是 How to: Set the Sizing Modes of the Windows 窗体 DataGridView 控件中提供的大型示例的一部分。
DataGridViewTextBoxColumn idColumn =
new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;
Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.HeaderText = "ID"
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None
idColumn.Resizable = DataGridViewTriState.False
idColumn.ReadOnly = True
idColumn.Width = 20
注解
控件 DataGridView 可以调整其列的大小,使其填充控件的可用水平宽度,或者使它们显示所有单元格或指定单元格的完整内容。
使用填充模式时,列的首选宽度是通过调整该模式下的所有列的大小来确定的,以便控件中的所有可见列完全填充可用显示区域的水平宽度。 与其他模式一样,首选列宽是显示该列中所有单元格或单元格子集的最大单元格值所需的最小宽度,例如当前显示的行中的单元格子集。 使用单元格子集来确定新宽度非常有用,以避免在处理多行数据时出现性能损失。
基于内容的自动调整大小可防止用户使用鼠标调整列宽。 但是,用户调整大小是在填充模式下启用的。
列和InheritedAutoSizeModeDataGridView.AutoResizeColumn方法的属性使用此AutoSizeMode枚举。
有关大小调整模式的详细信息,请参阅 dataGridView 控件中的Windows 窗体大小选项。 有关列填充模式的详细信息,请参阅 Windows 窗体 DataGridView 控件中的列填充模式。