DataGridView.AutoResizeColumns Метод

Определение

Корректирует ширину всех столбцов по содержимому их ячеек.Adjusts the width of all columns to fit the contents of their cells.

Перегрузки

AutoResizeColumns()

Корректирует ширину всех столбцов по содержимому всех их ячеек, включая ячейки заголовков.Adjusts the width of all columns to fit the contents of all their cells, including the header cells.

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Корректирует ширину всех столбцов с помощью заданного режима установки размеров.Adjusts the width of all columns using the specified size mode.

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

Настраивает ширину всех столбцов с помощью заданного режима установки размеров, при этом дополнительно ширина может рассчитываться исходя из предположения, что высота строк будет впоследствии скорректирована.Adjusts the width of all columns using the specified size mode, optionally calculating the widths with the expectation that row heights will subsequently be adjusted.

AutoResizeColumns()

Корректирует ширину всех столбцов по содержимому всех их ячеек, включая ячейки заголовков.Adjusts the width of all columns to fit the contents of all their cells, including the header cells.

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

Примеры

В следующем примере кода все столбцы изменяются в соответствии с содержимым столбцов и заголовков столбцов.The following code example resizes all columns to fit the contents of the columns and the column headers. Этот пример кода является частью большого примера, приведенного в разделе [How: Программным образом измените размер ячеек в соответствии с содержимым в элементе управления Windows Forms DataGridView @ no__t-0.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

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

Комментарии

Этот метод полезен, если требуется управлять изменением размера столбцов.This method is useful if you want to control when columns resize. Ширина столбцов корректируется только один раз в каждом вызове метода; Если содержимое столбцов в дальнейшем изменится, столбцы не будут корректироваться автоматически.The column widths are adjusted only once per method call; if the contents of the columns later change, the columns will not automatically adjust. Чтобы изменить размер определенного столбца, используйте метод AutoResizeColumn.To resize a specific column, use the AutoResizeColumn method. Чтобы задать автоматическое изменение размера столбцов при изменении их содержимого, используйте свойство AutoSizeColumnsMode или свойство Column AutoSizeMode.To set the columns to automatically resize whenever their contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

Дополнительные сведения о программном изменении размера см. в разделе Параметры изменения размера в элементе управления Windows Forms DataGridView.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Дополнительно

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Корректирует ширину всех столбцов с помощью заданного режима установки размеров.Adjusts the width of all columns using the specified size mode.

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.One of the DataGridViewAutoSizeColumnsMode values.

Исключения

autoSizeColumnsMode имеет значение ColumnHeader, а ColumnHeadersVisible равен false.autoSizeColumnsMode has the value ColumnHeader and ColumnHeadersVisible is false.

autoSizeColumnsMode имеет значение None или Fill.autoSizeColumnsMode has the value None or Fill.

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

Примеры

В следующем примере кода все столбцы изменяются в соответствии с содержимым столбцов и заголовков столбцов.The following code example resizes all columns to fit the contents of the columns and the column headers. Этот пример кода является частью большого примера, приведенного в разделе [How: Программным образом измените размер ячеек в соответствии с содержимым в элементе управления Windows Forms DataGridView @ no__t-0.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

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

Комментарии

Этот метод полезен, если требуется управлять изменением размера столбцов.This method is useful if you want to control when columns resize. Ширина столбцов корректируется только один раз в каждом вызове метода; Если содержимое столбцов в дальнейшем изменится, столбцы не будут корректироваться автоматически.The column widths are adjusted only once per method call; if the contents of the columns later change, the columns will not automatically adjust. Чтобы изменить размер определенного столбца, используйте метод AutoResizeColumn.To resize a specific column, use the AutoResizeColumn method. Чтобы задать автоматическое изменение размера столбцов при изменении их содержимого, используйте свойство AutoSizeColumnsMode или свойство Column AutoSizeMode.To set the columns to automatically resize whenever their contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

Эта перегрузка позволяет указать режим изменения размера, который вычисляет новые значения ширины на основе значений в ограниченном наборе ячеек, например только в отображаемых строках.This overload lets you specify a sizing mode that calculates the new widths based on values in a limited set of cells, such as those in displayed rows only. Это повышает производительность, если элемент управления содержит большое количество строк.This improves performance when the control contains a large number of rows.

Дополнительные сведения о программном изменении размера см. в разделе Параметры изменения размера в элементе управления Windows Forms DataGridView.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Дополнительно

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

Настраивает ширину всех столбцов с помощью заданного режима установки размеров, при этом дополнительно ширина может рассчитываться исходя из предположения, что высота строк будет впоследствии скорректирована.Adjusts the width of all columns using the specified size mode, optionally calculating the widths with the expectation that row heights will subsequently be adjusted.

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.One of the DataGridViewAutoSizeColumnsMode values.

fixedHeight
Boolean

Значение true, чтобы новая ширина рассчитывалась исходя из текущей высоты строк; значение false, чтобы ширина рассчитывалась исходя из предположения, что высота строк будет впоследствии также скорректирована.true to calculate the new widths based on the current row heights; false to calculate the widths with the expectation that the row heights will also be adjusted.

Исключения

autoSizeColumnsMode имеет значение ColumnHeader, а ColumnHeadersVisible равен false.autoSizeColumnsMode has the value ColumnHeader and ColumnHeadersVisible is false.

autoSizeColumnsMode имеет значение None или Fill.autoSizeColumnsMode has the value None or Fill.

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

Комментарии

Этот метод полезен, если требуется управлять изменением размера столбцов.This method is useful if you want to control when columns resize. Ширина столбцов корректируется только один раз в каждом вызове метода; Если содержимое столбцов в дальнейшем изменится, столбцы не будут корректироваться автоматически.The column widths are adjusted only once per method call; if the contents of the columns later change, the columns will not automatically adjust. Чтобы изменить размер определенного столбца, используйте метод AutoResizeColumn.To resize a specific column, use the AutoResizeColumn method. Чтобы задать автоматическое изменение размера столбцов при изменении их содержимого, используйте свойство AutoSizeColumnsMode или свойство Column AutoSizeMode.To set the columns to automatically resize whenever their contents change, use the AutoSizeColumnsMode property or the column AutoSizeMode property.

Эта перегрузка позволяет указать режим изменения размера, который вычисляет новые значения ширины на основе значений в ограниченном наборе ячеек, например только в отображаемых строках.This overload lets you specify a sizing mode that calculates the new widths based on values in a limited set of cells, such as those in displayed rows only. Это повышает производительность, если элемент управления содержит большое количество строк.This improves performance when the control contains a large number of rows.

Эта перегрузка защищена и разработана таким образом, чтобы обеспечить оптимальное соотношение высоты ячеек к ширине в производном классе DataGridView.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Если fixedHeight равно false, то ширина столбцов будет вычисляться с учетом ожидания вызова метода AutoResizeRow или AutoResizeRows Далее.If fixedHeight is false, the column widths will be calculated with the expectation that you will call the AutoResizeRow or AutoResizeRows method next.

Дополнительные сведения о программном изменении размера см. в разделе Параметры изменения размера в элементе управления Windows Forms DataGridView.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Дополнительно

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