DataGridView.AutoResizeRowHeadersWidth Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Корректирует ширину заголовков строк по содержимому заголовка.
Перегрузки
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode) |
Корректирует ширину заголовков строк с помощью заданного режима установки размеров. |
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode) |
Корректирует ширину заголовков строк на основе изменений содержимого заголовков в указанной строке и с помощью указанного режима установки размера. |
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean) |
Корректирует ширину заголовков строк с помощью заданного режима установки размеров. При этом дополнительно может быть рассчитана ширина в предположении, что ширина заголовков столбцов и строк будет впоследствии скорректирована. |
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean) |
Корректирует ширину заголовков строк на основе изменений, внесенных в содержимое заголовка в указанной строке и с помощью указанного режима установки размеров. При этом дополнительно может быть рассчитана ширина в предположении, что ширина заголовка столбца и строки будет впоследствии скорректирована. |
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)
Корректирует ширину заголовков строк с помощью заданного режима установки размеров.
public:
void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)
Параметры
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Одно из значений перечисления DataGridViewRowHeadersWidthSizeMode.
Исключения
rowHeadersWidthSizeMode
имеет значение EnableResizing или DisableResizing.
rowHeadersWidthSizeMode
не является допустимым значением DataGridViewRowHeadersWidthSizeMode.
Комментарии
Этот метод полезен, если вы хотите управлять изменением размера заголовков строк. Ширина заголовков строк настраивается только один раз для каждого вызова метода; Если содержимое заголовков строк позже изменится, заголовки строк не будут автоматически настраиваться. Чтобы задать автоматический размер заголовков строк при изменении их содержимого, используйте RowHeadersWidthSizeMode свойство.
Этот метод позволяет указать режим изменения размера, который вычисляет новую ширину на основе значений в ограниченном наборе заголовков, например только в отображаемых строках. Это повышает производительность, если элемент управления содержит большое количество строк.
Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления dataGridView Windows Forms.
См. также раздел
Применяется к
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)
Корректирует ширину заголовков строк на основе изменений содержимого заголовков в указанной строке и с помощью указанного режима установки размера.
public:
void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)
Параметры
- rowIndex
- Int32
Индекс заголовка строки, содержимое которого было изменено.
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Одно из значений перечисления DataGridViewRowHeadersWidthSizeMode.
Исключения
rowIndex
не находится в допустимом диапазоне от 0 до количества строк минус 1.
rowHeadersWidthSizeMode
имеет значение EnableResizing или DisableResizing.
rowHeadersWidthSizeMode
не является допустимым значением DataGridViewRowHeadersWidthSizeMode.
Примеры
В следующем примере кода показано, как изменить размер ширины заголовка строки на основе изменений содержимого первого заголовка строки. Этот пример кода является частью более крупного примера, приведенного в разделе "Практическое руководство. Программное изменение размера ячеек в соответствии с содержимым" в элементе управления dataGridView Windows Forms.
void SizeFirstRowHeaderToAllHeaders( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRowHeadersWidth(0, DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders);
}
private void SizeFirstRowHeaderToAllHeaders(Object sender, EventArgs e)
{
dataGridView1.AutoResizeRowHeadersWidth(
0, DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
Private Sub SizeFirstRowHeaderToAllHeaders(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button8.Click
DataGridView1.AutoResizeRowHeadersWidth( _
DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub
Комментарии
Этот метод полезен, если вы хотите управлять изменением размера заголовков строк, если только содержимое заголовка в указанной строке изменилось в результате изменения пользователем или изменения связанного источника данных. Ширина заголовков строк изменяется только один раз на вызов метода, если изменение содержимого требует его; Если содержимое заголовков строк позже изменится, заголовки строк не будут автоматически настраиваться. Чтобы задать автоматический размер заголовков строк при изменении их содержимого, используйте RowHeadersWidthSizeMode свойство.
Этот метод позволяет указать режим изменения размера, который вычисляет новую ширину на основе значений в ограниченном наборе заголовков, например только в отображаемых строках. Это повышает производительность, если элемент управления содержит большое количество строк.
Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления dataGridView Windows Forms.
См. также раздел
Применяется к
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)
Корректирует ширину заголовков строк с помощью заданного режима установки размеров. При этом дополнительно может быть рассчитана ширина в предположении, что ширина заголовков столбцов и строк будет впоследствии скорректирована.
protected:
void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
protected void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowsHeight As Boolean)
Параметры
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Одно из значений перечисления DataGridViewRowHeadersWidthSizeMode.
- fixedColumnHeadersHeight
- Boolean
Значение true
, чтобы новая ширина рассчитывалась исходя из текущей высоты заголовков столбцов; значение false
, чтобы ширина рассчитывалась исходя из предположения, что высота заголовков столбцов впоследствии также будет скорректирована.
- fixedRowsHeight
- Boolean
Значение true
, чтобы новая ширина рассчитывалась исходя из текущей высоты строк; значение false
, чтобы ширина рассчитывалась с предположением, что высота строк будет впоследствии также скорректирована.
Исключения
rowHeadersWidthSizeMode
имеет значение EnableResizing или DisableResizing.
rowHeadersWidthSizeMode
не является допустимым значением DataGridViewRowHeadersWidthSizeMode.
Комментарии
Этот метод полезен, если вы хотите управлять изменением размера заголовков строк. Ширина заголовков строк настраивается только один раз для каждого вызова метода; Если содержимое заголовков строк позже изменится, заголовки строк не будут автоматически настраиваться. Чтобы задать автоматический размер заголовков строк при изменении их содержимого, используйте RowHeadersWidthSizeMode свойство.
Этот метод позволяет указать режим изменения размера, который вычисляет новую ширину на основе значений в ограниченном наборе заголовков, например только в отображаемых строках. Это повышает производительность, если элемент управления содержит большое количество строк.
Эта перегрузка защищена и предназначена для достижения идеальных соотношений высоты к ширине ячеек в производном DataGridView классе. Если заданы fixedColumnHeadersHeight
false
параметрыfixedRowsHeight
, ширина заголовков строк будет вычисляться с учетом ожидания вызова таких методов, как AutoResizeRows и AutoResizeColumnHeadersHeight далее.
Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления dataGridView Windows Forms.
См. также раздел
Применяется к
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)
Корректирует ширину заголовков строк на основе изменений, внесенных в содержимое заголовка в указанной строке и с помощью указанного режима установки размеров. При этом дополнительно может быть рассчитана ширина в предположении, что ширина заголовка столбца и строки будет впоследствии скорректирована.
protected:
void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
protected void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowHeight As Boolean)
Параметры
- rowIndex
- Int32
Индекс строки, содержащей заголовок, содержимое которого было изменено.
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Одно из значений перечисления DataGridViewRowHeadersWidthSizeMode.
- fixedColumnHeadersHeight
- Boolean
Значение true
, чтобы новая ширина рассчитывалась исходя из текущей высоты заголовков столбцов; значение false
, чтобы ширина рассчитывалась исходя из предположения, что высота заголовков столбцов впоследствии также будет скорректирована.
- fixedRowHeight
- Boolean
Значение true
, чтобы новая ширина рассчитывалась исходя из текущей высоты указанной строки; значение false
, чтобы ширина рассчитывалась исходя из предположения, что высота этой строки впоследствии также будет скорректирована.
Исключения
rowIndex
не находится в допустимом диапазоне от 0 до количества строк минус 1.
rowHeadersWidthSizeMode
имеет значение EnableResizing или DisableResizing.
rowHeadersWidthSizeMode
не является допустимым значением DataGridViewRowHeadersWidthSizeMode.
Комментарии
Этот метод полезен, если вы хотите управлять изменением размера заголовков строк, если только содержимое заголовка в указанной строке изменилось в результате изменения пользователем или изменения связанного источника данных. Ширина заголовков строк изменяется только один раз на вызов метода, если изменение содержимого требует его; Если содержимое заголовков строк позже изменится, заголовки строк не будут автоматически настраиваться. Чтобы задать автоматический размер заголовков строк при изменении их содержимого, используйте RowHeadersWidthSizeMode свойство.
Этот метод позволяет указать режим изменения размера, который вычисляет новую ширину на основе значений в ограниченном наборе заголовков, например только в отображаемых строках. Это повышает производительность, если элемент управления содержит большое количество строк.
Эта перегрузка защищена и предназначена для достижения идеальных соотношений высоты к ширине ячеек в производном DataGridView классе. Если заданы fixedColumnHeadersHeight
false
параметрыfixedRowHeight
, ширина заголовков строк будет вычисляться с учетом ожидания вызова таких методов, как AutoResizeRows и AutoResizeColumnHeadersHeight далее.
Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления dataGridView Windows Forms.