DataGridView.AutoResizeRowHeadersWidth Метод

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Корректирует ширину заголовков строк по содержимому заголовка.

Перегрузки

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.

Исключения

ArgumentException

rowHeadersWidthSizeMode имеет значение EnableResizing или DisableResizing.

InvalidEnumArgumentException

rowHeadersWidthSizeMode не является допустимым значением DataGridViewRowHeadersWidthSizeMode.

Этот метод полезен, если вы хотите управлять изменением размера заголовков строк. Ширина заголовков строк настраивается только один раз для каждого вызова метода; Если содержимое заголовков строк позже изменится, заголовки строк не будут автоматически настраиваться. Чтобы задать автоматический размер заголовков строк при изменении их содержимого, используйте RowHeadersWidthSizeMode свойство.

Этот метод позволяет указать режим изменения размера, который вычисляет новую ширину на основе значений в ограниченном наборе заголовков, например только в отображаемых строках. Это повышает производительность, если элемент управления содержит большое количество строк.

Дополнительные сведения о программном изменении размера см. в разделе "Параметры изменения размера" в элементе управления dataGridView Windows Forms.

См. также раздел

элемент управления 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.

Исключения

ArgumentOutOfRangeException

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.

ArgumentException

rowHeadersWidthSizeMode имеет значение EnableResizing или DisableResizing.

InvalidEnumArgumentException

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, чтобы ширина рассчитывалась с предположением, что высота строк будет впоследствии также скорректирована.

Исключения

ArgumentException

rowHeadersWidthSizeMode имеет значение EnableResizing или DisableResizing.

InvalidEnumArgumentException

rowHeadersWidthSizeMode не является допустимым значением DataGridViewRowHeadersWidthSizeMode.

Эта перегрузка защищена и предназначена для достижения идеальных соотношений высоты к ширине ячеек в производном 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

fixedRowHeight: Boolean

Значение true, чтобы новая ширина рассчитывалась исходя из текущей высоты указанной строки; значение false, чтобы ширина рассчитывалась исходя из предположения, что высота этой строки впоследствии также будет скорректирована.

Исключения

ArgumentOutOfRangeException

rowIndex не находится в допустимом диапазоне от 0 до количества строк минус 1.

ArgumentException

rowHeadersWidthSizeMode имеет значение EnableResizing или DisableResizing.

InvalidEnumArgumentException

rowHeadersWidthSizeMode не является допустимым значением DataGridViewRowHeadersWidthSizeMode.

Эта перегрузка защищена и предназначена для достижения идеальных соотношений высоты к ширине ячеек в производном DataGridView классе. Если заданы fixedColumnHeadersHeight falseпараметрыfixedRowHeight, ширина заголовков строк будет вычисляться с учетом ожидания вызова таких методов, как AutoResizeRows и AutoResizeColumnHeadersHeight далее.

См. также раздел

элемент управления DataGridView (Windows Forms)

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

DataGridView.AutoResizeRowHeadersWidth Метод

Определение

Перегрузки

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Параметры

Исключения

Комментарии

См. также раздел

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

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

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

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Параметры

Исключения

Комментарии

См. также раздел

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

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Параметры

Исключения

Комментарии

См. также раздел

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

Дополнительные ресурсы