Udostępnij za pośrednictwem

DataGridView.RowTemplate Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia wiersz reprezentujący szablon dla wszystkich wierszy w kontrolce.

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

Wartość właściwości

DataGridViewRow

Reprezentujący DataGridViewRow szablon wiersza.

Atrybuty
BrowsableAttribute

Wyjątki

InvalidOperationException

Określony wiersz podczas ustawiania tej właściwości ma ustawiony jej DataGridView właściwość.

Przykłady

Poniższy przykład kodu ilustruje sposób użycia szablonu wiersza do określenia początkowej wysokości wiersza i minimalnej wysokości wiersza.

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

Uwagi

Czasami potrzebujesz większej kontroli nad wyglądem DataGridView wierszy niż to, co jest udostępniane przez różne DataGridView właściwości stylu komórki. Właściwość RowTemplate umożliwia tworzenie i inicjowanie DataGridViewRow elementu do użycia jako szablonu przez wszystkie wiersze, w tym wiersz dla nowych rekordów, jeśli AllowUserToAddRows ma wartość true.

Jest to przydatne w przypadku ustawiania wartości domyślnych dla właściwości, takich jak wysokość wiersza. Na przykład możesz zwiększyć domyślną wysokość wiersza, aby zapewnić dodatkowe miejsce pod zwykłą zawartością komórki na potrzeby wyświetlania zawartości obejmującej wiele kolumn.

Ustawienie szablonu wiersza jest konieczne, gdy dane zewnętrzne są wyświetlane przy użyciu typów niestandardowych pochodzących z DataGridViewRow klasy. Za pomocą niezwiązanych DataGridView kontrolek można programowo wypełnić Rows kolekcję wystąpieniami niestandardowego typu wiersza. Podczas wyświetlania danych zewnętrznych wiersze są generowane automatycznie, ale są oparte na szablonie wiersza, który można ustawić na wystąpienie niestandardowego typu wiersza.

Jeśli ta właściwość nie została ustawiona podczas pierwszego pobierania jej wartości, zostanie utworzona i zwrócona nowa DataGridViewRow właściwość.

Dotyczy

Zobacz też