DataGridView.RowTemplate Vlastnost

Definice

Získá nebo nastaví řádek, který představuje šablonu pro všechny řádky v ovládacím prvku.

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

Hodnota vlastnosti

DataGridViewRow

Představuje DataGridViewRow šablonu řádku.

Atributy

Výjimky

Zadaný řádek při nastavení této vlastnosti má nastavenou vlastnost DataGridView .

Příklady

Následující příklad kódu ukazuje, jak pomocí šablony řádku určit počáteční výšku řádku a minimální výšku řádku.

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

Poznámky

Někdy chcete mít větší kontrolu nad vzhledem DataGridView řádků, než jaké poskytují různé DataGridView vlastnosti stylu buňky. Vlastnost RowTemplate umožňuje vytvořit a inicializovat DataGridViewRow pro použití jako šablonu pro všechny řádky, včetně řádku pro nové záznamy, pokud AllowUserToAddRows je true.

To je užitečné, když nastavujete výchozí hodnoty pro vlastnosti, jako je výška řádku. Můžete například chtít zvětšit výchozí výšku řádku, aby se pod běžným obsahem buňky zobrazoval prostor navíc pro zobrazení obsahu, který pokrývá více sloupců.

Nastavení šablony řádku je nezbytné, pokud se externí data zobrazí pomocí vlastních typů odvozených z DataGridViewRow třídy. S nevázanými DataGridView ovládacími prvky můžete kolekci programově naplnit Rows instancemi vlastního typu řádku. Při zobrazení externích dat se ale řádky generují automaticky, ale jsou založené na šabloně řádku, kterou můžete nastavit na instanci vlastního typu řádku.

Pokud tato vlastnost nebyla nastavena při prvním načtení jeho hodnoty, vytvoří se a vrátí nová DataGridViewRow .

Platí pro

Viz také