DataGridView.AutoResizeRow Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Настраивает высоту указанной строки, чтобы соответствовать содержимому ее ячеек.
Перегрузки
| Имя | Описание |
|---|---|
| AutoResizeRow(Int32) |
Изменяет высоту указанной строки, чтобы соответствовать содержимому всех его ячеек, включая ячейку заголовка. |
| AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) |
Настраивает высоту указанной строки с помощью указанного режима размера. |
| AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) |
Настраивает высоту указанной строки с помощью указанного режима размера, при необходимости вычисляя высоту с ожиданием, что ширина столбца будет изменена впоследствии. |
AutoResizeRow(Int32)
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
Изменяет высоту указанной строки, чтобы соответствовать содержимому всех его ячеек, включая ячейку заголовка.
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 соответствии с содержимым столбца. Этот пример кода является частью более крупного примера, приведенного в разделе "Практическое руководство. Программное изменение размера ячеек в соответствии с содержимым в элементе управления DataGridView в Windows Forms".
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свойства.
Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления DataGridView в Windows Forms.
См. также раздел
Применяется к
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
Настраивает высоту указанной строки с помощью указанного режима размера.
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 соответствии с содержимым столбца. Этот пример кода является частью более крупного примера, приведенного в разделе "Практическое руководство. Программное изменение размера ячеек в соответствии с содержимым в элементе управления DataGridView в Windows Forms".
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свойства.
Эта перегрузка позволяет указать режим изменения размера, который вычисляет новую высоту на основе значений в ограниченном наборе ячеек, например только в отображаемых строках. Это повышает производительность, если элемент управления содержит большое количество строк.
Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления DataGridView в Windows Forms.
См. также раздел
Применяется к
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
Настраивает высоту указанной строки с помощью указанного режима размера, при необходимости вычисляя высоту с ожиданием, что ширина столбца будет изменена впоследствии.
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 метод.
Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления DataGridView в Windows Forms.