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, setPublic 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 свойство.
