DataGridView.AutoResizeRow Метод

Определение

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

Перегрузки

AutoResizeRow(Int32)

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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

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

AutoResizeRow(Int32)

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

public:
 void AutoResizeRow(int rowIndex);
public void AutoResizeRow (int rowIndex);
member this.AutoResizeRow : int -> unit
Public Sub AutoResizeRow (rowIndex As Integer)

Параметры

rowIndex
Int32

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

Исключения

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.

Примеры

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

void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

Комментарии

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

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

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

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

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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

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

public:
 void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode);
public void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode -> unit
Public Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode)

Параметры

rowIndex
Int32

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

autoSizeRowMode
DataGridViewAutoSizeRowMode

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

Исключения

autoSizeRowMode имеет значение RowHeader, а RowHeadersVisible равен false.

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

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.

Примеры

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

void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

Комментарии

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

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

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

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

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

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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

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

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

Параметры

rowIndex
Int32

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

autoSizeRowMode
DataGridViewAutoSizeRowMode

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

fixedWidth
Boolean

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

Исключения

autoSizeRowMode имеет значение RowHeader, а RowHeadersVisible равен false.

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

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.

Комментарии

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

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

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

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

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

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

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