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

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

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

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

Поля

AllCells 6

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

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

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

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

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

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

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

Примеры

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

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

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

Это перечисление используется свойством DataGridView элемента управления AutoSizeColumnsMode и AutoResizeColumns методом .

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

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

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