DataGridViewColumn.AutoSizeMode Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает режим, в котором автоматически изменяется ширина столбца.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };

public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }

member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set

Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

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

DataGridViewAutoSizeColumnMode

Значение DataGridViewAutoSizeColumnMode, определяющее, изменяется ли автоматически ширина столбца и как определяется ее предпочтительное значение. Значение по умолчанию — NotSet.

Исключения

InvalidEnumArgumentException

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

InvalidOperationException

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

-или-

Указанное значение, когда установка этого свойства приводит к тому, что свойство InheritedAutoSizeMode видимого столбца получает значение Fill, в то время как видимые столбцы заморожены.

Примеры

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

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Комментарии

Автоматическое изменение размера столбца определяется значением InheritedAutoSizeMode свойства , которое совпадает со значением AutoSizeMode свойства для всех значений, кроме NotSet, что указывает, что значение наследуется от DataGridView.AutoSizeColumnsMode свойства .

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

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

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

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

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

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

• DataGridView
• DataGridViewAutoSizeColumnMode
• AutoSizeColumnsMode
• InheritedAutoSizeMode
• Изменение размеров управления DataGridView в Windows Forms
• Изменение размера столбцов и строк элемента управления DataGridView в Windows Forms