DataGridView.AutoResizeRow Метод

Определение

Корректирует высоту указанной строки по содержимому ее ячеек.Adjusts the height of the specified row to fit the contents of its cells.

Перегрузки

AutoResizeRow(Int32)

Корректирует высоту указанной строки по содержимому всех ее ячеек, включая ячейку заголовка.Adjusts the height of the specified row to fit the contents of all its cells including the header cell.

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Корректирует высоту указанной строки с помощью заданного режима установки размеров.Adjusts the height of the specified row using the specified size mode.

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

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

AutoResizeRow(Int32)

Корректирует высоту указанной строки по содержимому всех ее ячеек, включая ячейку заголовка.Adjusts the height of the specified row to fit the contents of all its cells including the header cell.

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

Параметры

rowIndex
Int32

Индекс строки, размер которой будет изменен.The index of the row to resize.

Исключения

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

Примеры

В следующем примере кода третья строка изменяется в DataGridView в соответствии с содержимым столбца.The following code example resizes the third row in a DataGridView to fit the column contents. Этот пример кода является частью большого примера, приведенного в разделе как программно изменять размер ячеек в соответствии с содержимым в элементе управления Windows Forms DataGridView.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 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

Комментарии

Этот метод полезен, если требуется управлять изменением размера строки.This method is useful if you want to control when a row resizes. Высота строки корректируется только один раз для каждого вызова метода; Если содержимое строки позже изменится, строка не будет автоматически корректироваться.The row height is adjusted only once per method call; if the contents of the row later change, the row will not automatically adjust. Чтобы изменить размер всех строк, используйте метод AutoResizeRows.To resize all rows, use the AutoResizeRows method. Чтобы задать автоматическое изменение размера строки при изменении ее содержимого, используйте свойство AutoSizeRowsMode.To set the row to automatically resize whenever its contents change, use the AutoSizeRowsMode property.

Чтобы содержимое ячейки было перенесено на несколько строк при изменении размера строки, стиль ячейки, действующий для ячейки, должен иметь значение WrapMode свойства True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

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

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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

Корректирует высоту указанной строки с помощью заданного режима установки размеров.Adjusts the height of the specified row using the specified size mode.

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

Индекс строки, размер которой будет изменен.The index of the row to resize.

autoSizeRowMode
DataGridViewAutoSizeRowMode

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

Исключения

autoSizeRowMode имеет значение RowHeader, а RowHeadersVisible равен false.autoSizeRowMode has the value RowHeader and RowHeadersVisible is false.

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

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

Примеры

В следующем примере кода третья строка изменяется в DataGridView в соответствии с содержимым столбца.The following code example resizes the third row in a DataGridView to fit the column contents. Этот пример кода является частью большого примера, приведенного в разделе как программно изменять размер ячеек в соответствии с содержимым в элементе управления Windows Forms DataGridView.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 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

Комментарии

Этот метод полезен, если требуется управлять изменением размера строки.This method is useful if you want to control when a row resizes. Высота строки корректируется только один раз для каждого вызова метода; Если содержимое строки позже изменится, строка не будет автоматически корректироваться.The row height is adjusted only once per method call; if the contents of the row later change, the row will not automatically adjust. Чтобы изменить размер всех строк, используйте метод AutoResizeRows.To resize all rows, use the AutoResizeRows method. Чтобы задать автоматическое изменение размера строки при изменении ее содержимого, используйте свойство AutoSizeRowsMode.To set the row to automatically resize whenever its contents change, use the AutoSizeRowsMode property.

Чтобы содержимое ячейки было перенесено на несколько строк при изменении размера строки, стиль ячейки, действующий для ячейки, должен иметь значение WrapMode свойства True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Эта перегрузка позволяет указать режим изменения размера, который вычисляет новую высоту на основе значений в ограниченном наборе ячеек, например только в отображаемых строках.This overload lets you specify a sizing mode that calculates the new height 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.

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

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

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

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

Индекс строки, размер которой будет изменен.The index of the row to resize.

autoSizeRowMode
DataGridViewAutoSizeRowMode

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

fixedWidth
Boolean

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

Исключения

autoSizeRowMode имеет значение RowHeader, а RowHeadersVisible равен false.autoSizeRowMode has the value RowHeader and RowHeadersVisible is false.

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

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.rowIndex is not in the valid range of 0 to the number of rows minus 1.

Комментарии

Этот метод полезен, если требуется управлять изменением размера строки.This method is useful if you want to control when a row resizes. Высота строки корректируется только один раз для каждого вызова метода; Если содержимое строки позже изменится, строка не будет автоматически корректироваться.The row height is adjusted only once per method call; if the contents of the row later change, the row will not automatically adjust. Чтобы изменить размер всех строк, используйте метод AutoResizeRows.To resize all rows, use the AutoResizeRows method. Чтобы задать автоматическое изменение размера строки при изменении ее содержимого, используйте свойство AutoSizeRowsMode.To set the row to automatically resize whenever its contents change, use the AutoSizeRowsMode property.

Чтобы содержимое ячейки было перенесено на несколько строк при изменении размера строки, стиль ячейки, действующий для ячейки, должен иметь значение WrapMode свойства True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Эта перегрузка позволяет указать режим изменения размера, который вычисляет новую высоту на основе значений в ограниченном наборе ячеек, например только в отображаемых строках.This overload lets you specify a sizing mode that calculates the new height 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. Если fixedWidth false, то высота строки будет вычисляться с учетом ожидания, который будет вызывать метод AutoResizeColumn или AutoResizeColumns далее.If fixedWidth is false, the row height will be calculated with the expectation that you will call the AutoResizeColumn or AutoResizeColumns method next.

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

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

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