DataGridView.RowTemplate Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de rij op die de sjabloon vertegenwoordigt voor alle rijen in het besturingselement of stelt u deze in.
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 DataGridViewRowWaarde van eigenschap
Een DataGridViewRow weergave van de rijsjabloon.
- Kenmerken
Uitzonderingen
De opgegeven rij bij het instellen van deze eigenschap heeft de DataGridView eigenschap ingesteld.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de rijsjabloon gebruikt om een initiële rijhoogte en een minimale rijhoogte op te geven.
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
Opmerkingen
Soms wilt u meer controle over het uiterlijk van DataGridView rijen dan wat wordt geleverd door de verschillende DataGridView eigenschappen van de celstijl. Met de RowTemplate eigenschap kunt u een DataGridViewRow sjabloon maken en initialiseren voor gebruik als sjabloon voor alle rijen, inclusief de rij voor nieuwe records als AllowUserToAddRows dat het is true.
Dit is handig wanneer u standaardwaarden instelt voor eigenschappen zoals rijhoogte. U kunt bijvoorbeeld de standaardrijhoogte verhogen om extra ruimte te bieden onder gewone celinhoud voor het weergeven van inhoud die meerdere kolommen omvat.
Het instellen van de rijsjabloon is nodig wanneer externe gegevens worden weergegeven met behulp van aangepaste typen die zijn afgeleid van de DataGridViewRow klasse. Met niet-afhankelijke DataGridView besturingselementen kunt u de Rows verzameling programmatisch vullen met exemplaren van uw aangepaste rijtype. Bij het weergeven van externe gegevens worden de rijen echter automatisch gegenereerd, maar ze zijn gebaseerd op de rijsjabloon, die u kunt instellen op een exemplaar van uw aangepaste rijtype.
Als deze eigenschap niet is ingesteld wanneer u de waarde voor het eerst ophaalt, wordt er een nieuwe DataGridViewRow gemaakt en geretourneerd.