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