DataGridViewAutoSizeColumnMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет значения для указания способа, которым регулируется ширина столбца.
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. |
Примеры
В следующем примере кода показано использование этого перечисления для настройки столбца фиксированной ширины. Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Настройка режимов изменения размера элемента управления 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.
Применяется к
См. также раздел
- DataGridView
- AutoSizeMode
- AutoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
- AutoResizeColumn
- AutoResizeColumns
- Изменение размеров управления DataGridView в Windows Forms
- Установка режимов заполнения для столбцов элемента управления DataGridView в Windows Forms
- Практическое руководство. Режимы изменения размеров элемента управления DataGridView в Windows Forms