DataGridViewAutoSizeColumnMode Перечисление

Определение

Определяет значения для указания способа, которым регулируется ширина столбца.

public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode = 
Public Enum DataGridViewAutoSizeColumnMode
Наследование
DataGridViewAutoSizeColumnMode

Поля

AllCells 6

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, включая ячейку заголовка.

AllCellsExceptHeader 4

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, за исключением ячейки заголовка.

ColumnHeader 2

Ширина столбца изменяется так, чтобы вместить содержимое ячейки заголовка для столбца.

DisplayedCells 10

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, которые находятся в строках, отображающихся на экране в настоящий момент, включая строку заголовка.

DisplayedCellsExceptHeader 8

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, которые находятся в строках, отображающихся на экране в настоящий момент, за исключением строки заголовка.

Fill 16

Ширина столбца подбирается таким образом, чтобы суммарная ширина всех столбцов в точности заполняла отображаемую область элемента управления, а прокрутка по горизонтали требовалась только для столбцов, ширина которых превышает значение свойства MinimumWidth. Относительная ширина столбцов определяется относительными значениями свойства FillWeight.

None 1

Значения ширины столбцов не изменяются автоматически.

NotSet 0

Режим изменения размеров столбца наследуется из свойства AutoSizeColumnsMode.

Примеры

В следующем примере кода показано использование этого перечисления для настройки столбца фиксированной ширины. Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Настройка режимов изменения размера элемента управления Windows Forms 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 управления может изменять размер своих столбцов, чтобы они заполняли доступную горизонтальную ширину элемента управления или отображали полное содержимое всех ячеек или указанных ячеек.

В режиме заливки предпочтительная ширина столбца определяется путем изменения размера всех столбцов в этом режиме, чтобы все видимые столбцы элемента управления точно заполняли горизонтальную ширину доступной области отображения. В других режимах предпочтительная ширина столбца — это минимальная ширина, необходимая для отображения наибольшего значения ячейки из всех ячеек или подмножества ячеек в этом столбце, например подмножества ячеек, которые находятся в текущих строках. Использование подмножества ячеек для определения новой ширины полезно, чтобы избежать снижения производительности при работе со многими строками данных.

Автоматическое изменение размера на основе содержимого предотвращает изменение ширины столбцов с помощью мыши. Однако изменение размера пользователя включено в режиме заполнения.

Это перечисление используется столбцами и InheritedAutoSizeMode свойствами AutoSizeMode столбцов и DataGridView.AutoResizeColumn метода.

Дополнительные сведения о режимах изменения размера см. в разделе "Параметры изменения размера" в элементе управления Windows Forms DataGridView. Дополнительные сведения о режиме заполнения столбцов, в частности, см. в разделе "Режим заполнения столбцов" в элементе управления Windows Forms DataGridView.

Применяется к

См. также раздел