DataGridView.AutoSizeRowsMode Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridView.cs

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

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 заголовков строк скрыты.

Примеры

В следующем примере кода показано, как настроить строку для автоматического изменения размера на основе содержимого заголовков строк и всех столбцов. Этот пример кода является частью более крупного примера, приведенного в разделе "Практическое руководство. Автоматическое изменение размера ячеек при изменении содержимого в элементе управления DataGridView в Windows Forms".

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 этот параметр включен, высота строк также настраивается при изменении ширины столбцов. Некоторые режимы изменения размера позволяют ограничить размер отображаемыми в данный момент строками, чтобы повысить производительность.

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

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

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

Для переноса содержимого ячейки на несколько строк при изменении размера строки стиль ячейки, действующий для ячейки, должен иметь WrapMode значение Trueсвойства.

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

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

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