DataGridView.RowTemplate Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridView.cs

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

BrowsableAttribute

Výjimky

InvalidOperationException

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

Příklady

Následující příklad kódu ukazuje, jak pomocí šablony řádku zadat 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 obsahem obyčejné buňky zobrazil prostor navíc pro zobrazení obsahu, který pokrývá více sloupců.

Nastavení šablony řádku je nezbytné, když se externí data zobrazí pomocí vlastních typů odvozených z DataGridViewRow třídy. Pomocí nevázaných DataGridView ovládacích prvků 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í její hodnoty, vytvoří se a vrátí nová DataGridViewRow .

Viz také

• Ovládací prvek DataGridView (Windows Forms)