DataGridView.AutoSizeRowsMode Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает значение, указывающее, как определяется высота строки.

public:
 property System::Windows::Forms::DataGridViewAutoSizeRowsMode AutoSizeRowsMode { System::Windows::Forms::DataGridViewAutoSizeRowsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeRowsMode value); };

public System.Windows.Forms.DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get; set; }

member this.AutoSizeRowsMode : System.Windows.Forms.DataGridViewAutoSizeRowsMode with get, set

Public Property AutoSizeRowsMode As DataGridViewAutoSizeRowsMode

Значение свойства

DataGridViewAutoSizeRowsMode

Значение DataGridViewAutoSizeRowsMode, указывающее режим изменения размеров. Значение по умолчанию — None.

Исключения

InvalidEnumArgumentException

Указанное при задании этого свойства значение не является допустимым значением DataGridViewAutoSizeRowsMode.

InvalidOperationException

Указанное значение при задании этого свойства равно AllHeaders или DisplayedHeaders, и заголовки строк скрыты.

Примеры

В следующем примере кода показано, как настроить автоматическое изменение размера строки на основе содержимого заголовков строк и всех столбцов. Этот пример кода является частью более крупного примера, приведенного в разделе How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}

private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

Комментарии

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

Автоматически изменяются только строки со значением Visibletrue свойства , и изменение видимости строки не приводит к изменению размера. Кроме того, если для строк задано автоматическое изменение размера, пользователь не может настроить высоту строк с помощью мыши.

Значение Height строки с автоматическим размером пересчитывается во время макета с учетом размера используемого шрифта. Чтобы получить правильный Heightкод , следует извлечь значение в событии формы, а не Layout в конструкторе формы.

Чтобы программно настроить высоту строк, используйте AutoResizeRow методы или AutoResizeRows или задайте свойство строки Height .

Чтобы содержимое ячейки переносилось на несколько строк при изменении размера строки, стиль ячейки, который действует для ячейки, должен иметь WrapMode значение Trueсвойства .

Дополнительные сведения об автоматическом изменении размера на основе содержимого см. в разделе Параметры изменения размера элемента управления Windows Forms DataGridView.

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

• DataGridViewAutoSizeRowsMode
• элемент управления DataGridView (Windows Forms)
• Практическое руководство. Автоматическое изменение размера ячеек при изменении содержимого в элементе управления DataGridView в Windows Forms