Поделиться через


DataGridView.RowTemplate Свойство

Определение

Возвращает или задает строку, представляющую шаблон для всех строк в элементе управления.

public:
 property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, set
Public Property RowTemplate As DataGridViewRow

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

Объект DataGridViewRow, представляющий шаблон строки.

Атрибуты

Исключения

Указанная строка, если при настройке этого свойства для нее настроено свойство DataGridView.

Примеры

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

DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;
DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;
With Me.dataGridView1.RowTemplate
    .DefaultCellStyle.BackColor = Color.Bisque
    .Height = 35
    .MinimumHeight = 20
End With

Комментарии

Иногда требуется больший DataGridView контроль над внешним видом строк, чем обеспечивается различными DataGridView свойствами стиля ячеек. Свойство RowTemplate позволяет создать и инициализировать DataGridViewRow для использования в качестве шаблона во всех строках, включая строку для новых записей, если AllowUserToAddRows имеет значение true.

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

Задание шаблона строки необходимо при отображении внешних данных с помощью пользовательских типов, производных DataGridViewRow от класса . С помощью несвязанных DataGridView элементов управления можно программно заполнить коллекцию Rows экземплярами пользовательского типа строки. Однако при отображении внешних данных строки создаются автоматически, но они основаны на шаблоне строки, который можно задать для экземпляра настраиваемого типа строки.

Если это свойство не было задано при первом получении его значения, создается и возвращается новое DataGridViewRow свойство.

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

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