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

Определение

Определяет значения для указания способа, которым регулируется ширина столбца.Defines values for specifying how the width of a column is adjusted.

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

Поля

AllCells 6

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, включая ячейку заголовка.The column width adjusts to fit the contents of all cells in the column, including the header cell.

AllCellsExceptHeader 4

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, за исключением ячейки заголовка.The column width adjusts to fit the contents of all cells in the column, excluding the header cell.

ColumnHeader 2

Ширина столбца изменяется так, чтобы вместить содержимое ячейки заголовка для столбца.The column width adjusts to fit the contents of the column header cell.

DisplayedCells 10

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, которые находятся в строках, отображающихся на экране в настоящий момент, включая строку заголовка.The column width adjusts to fit the contents of all cells in the column that are in rows currently displayed onscreen, including the header cell.

DisplayedCellsExceptHeader 8

Ширина столбца изменяется так, чтобы вместить содержимое всех ячеек столбца, которые находятся в строках, отображающихся на экране в настоящий момент, за исключением строки заголовка.The column width adjusts to fit the contents of all cells in the column that are in rows currently displayed onscreen, excluding the header cell.

Fill 16

Ширина столбца подбирается таким образом, чтобы суммарная ширина всех столбцов в точности заполняла отображаемую область элемента управления, а прокрутка по горизонтали требовалась только для столбцов, ширина которых превышает значение свойства MinimumWidth.The column width adjusts so that the widths of all columns exactly fills the display area of the control, requiring horizontal scrolling only to keep column widths above the MinimumWidth property values. Относительная ширина столбцов определяется относительными значениями свойства FillWeight.Relative column widths are determined by the relative FillWeight property values.

None 1

Значения ширины столбцов не изменяются автоматически.The column width does not automatically adjust.

NotSet 0

Режим изменения размеров столбца наследуется из свойства AutoSizeColumnsMode.The sizing behavior of the column is inherited from the AutoSizeColumnsMode property.

Примеры

В следующем примере кода показано использование этого перечисления для настройки столбца фиксированной ширины.The following code example illustrates the use of this enumeration to configure a fixed-width column. Этот пример является частью большого примера, доступного в разделе как задать режимы изменения размера элемента управления Windows Forms DataGridView.This example is part of a larger example available in How to: Set the Sizing Modes of the Windows Forms DataGridView Control.

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Элемент управления может изменить размер своих столбцов, чтобы они заполнили доступную горизонтальную ширину элемента управления или отображали все содержимое всех ячеек или указанных ячеек.The DataGridView control can resize its columns to make them fill the available horizontal width of the control or to make them display the full contents of all cells or of specified cells.

В режиме заполнения Предпочтительная ширина столбца определяется путем изменения размера всех столбцов в этом режиме, чтобы все видимые столбцы в элементе управления точно заполнили горизонтальную ширину доступной области отображения.With Fill mode, the preferred width of a column is determined by resizing all columns in that mode so that all visible columns in the control exactly fill the horizontal width of the available display area. В других режимах Предпочтительная ширина столбца является минимальной шириной, необходимой для отображения самого большого значения ячейки из всех ячеек или подмножества ячеек в этом столбце, например подмножества ячеек, отображаемых в настоящий момент строками.With other modes, the preferred column width is the minimum width required to display the largest cell value from all cells or a subset of cells in that column, such as the subset of cells that are in currently displayed rows. Использование подмножества ячеек для определения новой ширины полезно для того, чтобы избежать снижения производительности при работе с большим количеством строк данных.Using a subset of cells to determine the new width is useful to avoid a performance penalty when working with many rows of data.

Автоматическое изменение размера на основе содержимого не позволяет пользователям настраивать ширину столбцов с помощью мыши.Content-based automatic resizing prevents users from adjusting column widths with the mouse. Однако изменение размера пользователя включено в режиме заполнения.User resizing is enabled in fill mode, however.

Это перечисление используется AutoSizeMode свойствами и InheritedAutoSizeMode столбцов и DataGridView.AutoResizeColumn метода.This enumeration is used by the AutoSizeMode and InheritedAutoSizeMode properties of columns and the DataGridView.AutoResizeColumn method.

Дополнительные сведения о режимах изменения размеров см. в разделе Параметры изменения размера в элементе управления Windows Forms DataGridView.For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control. Дополнительные сведения о режиме заполнения столбца в частности см. в разделе режим заполнения столбца в элементе управления Windows Forms DataGridView.For more information about column fill mode in particular, see Column Fill Mode in the Windows Forms DataGridView Control.

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

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