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.
См. также раздел
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по