DataGridView.AutoResizeColumns Метод

  • Ссылка

Определение

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

Корректирует ширину всех столбцов по содержимому их ячеек.

Перегрузки

AutoResizeColumns()

Корректирует ширину всех столбцов по содержимому всех их ячеек, включая ячейки заголовков.
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Корректирует ширину всех столбцов с помощью заданного режима установки размеров.
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

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

AutoResizeColumns()

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

public:
 void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()

Примеры

В следующем примере кода изменяется размер всех столбцов в соответствии с содержимым столбцов и заголовков столбцов. Этот пример кода является частью более крупного примера, представленного в разделе "Практическое руководство. Программное изменение размера ячеек в соответствии с содержимым" в элементе управления DataGridView Windows Forms.

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}

private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}

Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

Комментарии

Этот метод полезен, если требуется управлять изменением размера столбцов. Ширина столбца корректируется только один раз для каждого вызова метода; Если содержимое столбцов изменится позже, столбцы не будут автоматически настраиваться. Чтобы изменить размер определенного столбца, используйте AutoResizeColumn метод. Чтобы настроить автоматическое изменение размера столбцов при изменении их содержимого, используйте AutoSizeColumnsMode свойство или свойство столбца AutoSizeMode .

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

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

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

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Корректирует ширину всех столбцов с помощью заданного режима установки размеров.

public:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)

Параметры

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

Одно из значений перечисления DataGridViewAutoSizeColumnsMode.

Исключения

InvalidOperationException

autoSizeColumnsMode имеет значение ColumnHeader, а ColumnHeadersVisible равен false.

ArgumentException

autoSizeColumnsMode имеет значение None или Fill.

InvalidEnumArgumentException

autoSizeColumnsMode не является допустимым значением DataGridViewAutoSizeColumnsMode.

Примеры

В следующем примере кода изменяется размер всех столбцов в соответствии с содержимым столбцов и заголовков столбцов. Этот пример кода является частью более крупного примера, представленного в разделе "Практическое руководство. Программное изменение размера ячеек в соответствии с содержимым" в элементе управления DataGridView Windows Forms.

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}

private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}

Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

Комментарии

Этот метод полезен, если требуется управлять изменением размера столбцов. Ширина столбца корректируется только один раз для каждого вызова метода; Если содержимое столбцов изменится позже, столбцы не будут автоматически настраиваться. Чтобы изменить размер определенного столбца, используйте AutoResizeColumn метод. Чтобы настроить автоматическое изменение размера столбцов при изменении их содержимого, используйте AutoSizeColumnsMode свойство или свойство столбца AutoSizeMode .

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

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

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

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

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

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

protected:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)

Параметры

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

Одно из значений перечисления DataGridViewAutoSizeColumnsMode.

fixedHeight
Boolean

Значение true, чтобы новая ширина рассчитывалась исходя из текущей высоты строк; значение false, чтобы ширина рассчитывалась исходя из предположения, что высота строк будет впоследствии также скорректирована.

Исключения

InvalidOperationException

autoSizeColumnsMode имеет значение ColumnHeader, а ColumnHeadersVisible равен false.

ArgumentException

autoSizeColumnsMode имеет значение None или Fill.

InvalidEnumArgumentException

autoSizeColumnsMode не является допустимым значением DataGridViewAutoSizeColumnsMode.

Комментарии

Этот метод полезен, если требуется управлять изменением размера столбцов. Ширина столбца корректируется только один раз для каждого вызова метода; Если содержимое столбцов изменится позже, столбцы не будут автоматически настраиваться. Чтобы изменить размер определенного столбца, используйте AutoResizeColumn метод. Чтобы настроить автоматическое изменение размера столбцов при изменении их содержимого, используйте AutoSizeColumnsMode свойство или свойство столбца AutoSizeMode .

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

Эта перегрузка защищена и предназначена для достижения идеальных коэффициентов высоты и ширины ячеек в производном DataGridView классе. В противном fixedHeight случае falseширина столбца вычисляется с учетом того, что вы вызовете AutoResizeRow следующий метод или AutoResizeRows метод.

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

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

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