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

Определение

Определяет значения для указания способа регулирования ширины столбцов.Defines values for specifying how the widths of columns are adjusted.

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

Поля

AllCells 6

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

AllCellsExceptHeader 4

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

ColumnHeader 2

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

DisplayedCells 10

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

DisplayedCellsExceptHeader 8

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

Fill 16

Ширина столбцов подбирается таким образом, чтобы суммарная ширина всех столбцов в точности заполняла отображаемую область элемента управления, а прокрутка по горизонтали требовалась только для того, чтобы не допускать уменьшения ширины столбцов ниже значений свойства MinimumWidth.The column widths adjust so that the widths of all columns exactly fill 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 widths do not automatically adjust.

Примеры

В следующем примере кода показано использование этого перечисления в сценарии "основной/подробности", где два DataGridView элемента управления отображают данные из двух таблиц в связи "родители-потомки".The following code example illustrates the use of this enumeration in a master/details scenario where two DataGridView controls display data from two tables in a parent/child relationship. В этом примере режим изменения размера столбца для главного элемента управления равен None, а ширина столбцов инициализируется программно, чтобы они соответствовали загруженным значениям.In this example, the column sizing mode for the master control is None and the column widths are programmatically initialized to fit the loaded values. Для элемента управления подробными данными задан режим автоматического изменения размера, чтобы столбцы автоматически изменялись при изменении значений (например, когда пользователь изменяет текущую строку в родительской таблице).The details control is set to an automatic sizing mode so that columns will adjust automatically whenever the values change (for example, when the user changes the current row in the parent table). Этот пример является частью большого примера, доступного в разделе как создать форму "основной/подробности" с помощью двух элементов управления Windows Forms DataGridView.This example is part of a larger example available in How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

Комментарии

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.

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

Это перечисление используется DataGridView AutoSizeColumnsMode свойством элемента управления и AutoResizeColumns методом.This enumeration is used by the DataGridView control AutoSizeColumnsMode property and AutoResizeColumns 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.

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

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