DataGridView.AutoResizeRows Метод

Определение

Корректирует высоту некоторых или всех строк по их содержимому.

Перегрузки

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Корректирует высоту строк с помощью заданного значения режима установки размеров.

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

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

AutoResizeRows()

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

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

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

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Корректирует высоту строк с помощью заданного значения режима установки размеров.

public:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode);
public void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode -> unit
Public Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode)

Параметры

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

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

Исключения

autoSizeRowsMode имеет значение AllHeaders или DisplayedHeaders, а RowHeadersVisible равен false.

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

autoSizeRowsMode имеет значение None.

Примеры

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

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Комментарии

Этот метод удобен, если вы хотите управлять изменением размера строк. Высота строк корректируется только один раз для каждого вызова метода; Если позднее содержимое строк изменится, строки не будут автоматически настраиваться. Чтобы изменить размер определенной строки, используйте AutoResizeRow метод . Чтобы изменить размер подмножества строк, используйте перегрузку AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) . Чтобы настроить автоматическое изменение размера строк при изменении их содержимого AutoSizeRowsMode , используйте свойство .

Чтобы содержимое ячейки переносилось на несколько строк при изменении размера строки, стиль ячейки, который действует для ячейки, должен иметь WrapMode значение Trueсвойства .

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

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

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

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

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

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

protected:
 void AutoResizeRows(int rowIndexStart, int rowsCount, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRows (int rowIndexStart, int rowsCount, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRows : int * int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRows (rowIndexStart As Integer, rowsCount As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Параметры

rowIndexStart
Int32

Индекс первой строки, размер которой будет изменен.

rowsCount
Int32

Число строк, размер которых будет изменен.

autoSizeRowMode
DataGridViewAutoSizeRowMode

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

fixedWidth
Boolean

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

Исключения

autoSizeRowsMode имеет значение AllHeaders или DisplayedHeaders, а RowHeadersVisible равен false.

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

autoSizeRowsMode имеет значение None.

Значение параметраrowIndexStart меньше 0.

-или-

Значение параметраrowsCount меньше 0.

Комментарии

Этот метод удобен, если вы хотите управлять изменением размера строк, но вы хотите изменить размер только определенного подмножества строк, таких как в диапазоне привязанных записей, которые были обновлены. Высота строк для указанных строк корректируется только один раз для каждого вызова метода; Если позднее содержимое строк изменится, строки не будут автоматически настраиваться. Чтобы изменить размер определенной строки, используйте AutoResizeRow метод . Чтобы изменить размер всех строк, используйте другую перегрузку AutoResizeRows метода . Чтобы настроить автоматическое изменение размера строк при изменении их содержимого AutoSizeRowsMode , используйте свойство .

Чтобы содержимое ячейки переносилось на несколько строк при изменении размера строки, стиль ячейки, который действует для ячейки, должен иметь WrapMode значение Trueсвойства .

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

Эта перегрузка защищена и предназначена для достижения идеального соотношения высоты ячейки к ширине в производном DataGridView классе. fixedWidth Если параметр имеет значение false, высота строк будет вычисляться с расчетом на то, что далее будет вызываться AutoResizeColumn метод или AutoResizeColumns .

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

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

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

AutoResizeRows()

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

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

Примеры

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

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Комментарии

Этот метод удобен, если вы хотите управлять изменением размера строк. Высота строк корректируется только один раз для каждого вызова метода; Если позднее содержимое строк изменится, строки не будут автоматически настраиваться. Чтобы изменить размер определенной строки, используйте AutoResizeRow метод . Чтобы изменить размер подмножества строк, используйте перегрузку AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) . Чтобы настроить автоматическое изменение размера строк при изменении их содержимого AutoSizeRowsMode , используйте свойство .

Чтобы содержимое ячейки переносилось на несколько строк при изменении размера строки, стиль ячейки, который действует для ячейки, должен иметь WrapMode значение Trueсвойства .

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

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

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

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

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

protected:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
protected void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode * bool -> unit
Protected Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode, fixedWidth As Boolean)

Параметры

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

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

fixedWidth
Boolean

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

Исключения

autoSizeRowsMode имеет значение AllHeaders или DisplayedHeaders, а RowHeadersVisible равен false.

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

autoSizeRowsMode имеет значение None.

Комментарии

Этот метод удобен, если вы хотите управлять изменением размера строк. Высота строк корректируется только один раз для каждого вызова метода; Если позднее содержимое строк изменится, строки не будут автоматически настраиваться. Чтобы изменить размер определенной строки, используйте AutoResizeRow метод . Чтобы изменить размер подмножества строк, используйте перегрузку AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) . Чтобы настроить автоматическое изменение размера строк при изменении их содержимого AutoSizeRowsMode , используйте свойство .

Чтобы содержимое ячейки переносилось на несколько строк при изменении размера строки, стиль ячейки, который действует для ячейки, должен иметь WrapMode значение Trueсвойства .

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

Эта перегрузка защищена и предназначена для достижения идеального соотношения высоты ячейки к ширине в производном DataGridView классе. fixedWidth Если параметр имеет значение false, высота строк будет вычисляться с расчетом на то, что далее будет вызываться AutoResizeColumn метод или AutoResizeColumns .

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

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

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