DataGridView.AutoSizeColumnsMode Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает значение, указывающее, как определяется ширина столбца.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { System::Windows::Forms::DataGridViewAutoSizeColumnsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnsMode value); };

public System.Windows.Forms.DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }

member this.AutoSizeColumnsMode : System.Windows.Forms.DataGridViewAutoSizeColumnsMode with get, set

Public Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsMode

Значение свойства

DataGridViewAutoSizeColumnsMode

Значение DataGridViewAutoSizeColumnsMode. Значение по умолчанию — None.

Исключения

InvalidEnumArgumentException

Указанное при задании этого свойства значение не является допустимым значением DataGridViewAutoSizeColumnsMode.

InvalidOperationException

Указанное значение при задании этого свойства равно ColumnHeader, заголовки столбцов скрыты, и как минимум один видимый столбец имеет свойство AutoSizeMode со значением NotSet.

-или- Указанное значение при задании этого свойства равно Fill, и как минимум один видимый столбец, имеющий свойство AutoSizeMode со значением NotSet, зафиксирован.

Примеры

В следующем примере кода показано, как использовать это свойство в сценарии основных и подробных сведений, в котором два DataGridView элемента управления отображают данные из двух таблиц в связи "родители-потомки". В этом примере используется Noneрежим изменения размера столбцов для главного элемента управления, а ширина столбца инициализируется программным способом в соответствии с загруженными значениями. Элемент управления сведениями устанавливается в режим автоматического изменения размера столбцов, чтобы столбцы автоматически изменялись при изменении значений (например, когда пользователь изменяет текущую строку в родительской таблице). Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Создание формы master/Detail с помощью двух Windows Forms элементов управления DataGridView".

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

Комментарии

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

Чтобы изменить режим изменения размера для отдельного столбца, задайте его AutoSizeMode свойство. Значение этого свойства по умолчанию указывает NotSet, что столбец наследует его поведение и его InheritedAutoSizeMode значение свойства от элемента управления.

Столбцы в режиме заполнения разделяют доступную ширину элемента управления на пропорции, обозначаемые значениями их FillWeight свойств. Ширина, доступная для режима заполнения, определяется путем вычитания ширины всех остальных столбцов из ширины клиентской области элемента управления. Если эта ширина меньше объединенных MinimumWidth значений всех столбцов режима заполнения, отображается горизонтальная полоса прокрутки, все столбцы режима заполнения отображаются с минимальной шириной, а изменение размера столбцов пользователя отключено. Дополнительные сведения о режиме заполнения столбцов см. в разделе "Режим заполнения столбцов" в элементе управления Windows Forms DataGridView.

Только столбцы со Visible значением true свойства изменяются автоматически, и изменение видимости столбца не приводит к изменению размера столбца. Кроме того, если для столбцов задано автоматическое изменение размера, пользователь не может настроить ширину столбцов с помощью мыши.

Чтобы программно настроить ширину столбцов, используйте AutoResizeColumn или AutoResizeColumns методы или задайте свойство столбца Width .

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

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

• DataGridViewAutoSizeColumnsMode
• FillWeight
• элемент управления DataGridView (Windows Forms)