Partager via


DataGridView.RowTemplate Propriété

Définition

Obtient ou définit la ligne qui représente le modèle pour toutes les lignes dans le contrôle.

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

Valeur de propriété

DataGridViewRow représentant le modèle de ligne.

Attributs

Exceptions

La propriété DataGridView de la ligne spécifiée lors de la définition de cette propriété est définie.

Exemples

L’exemple de code suivant montre comment utiliser le modèle de ligne pour spécifier une hauteur de ligne initiale et une hauteur de ligne minimale.

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

Remarques

Parfois, vous souhaitez mieux contrôler l’apparence des DataGridView lignes que ce qui est fourni par les différentes DataGridView propriétés de style de cellule. La RowTemplate propriété vous permet de créer et d’initialiser un DataGridViewRow pour une utilisation en tant que modèle par toutes les lignes, y compris la ligne pour les nouveaux enregistrements si AllowUserToAddRows est true.

Cela est utile lorsque vous définissez des valeurs par défaut pour des propriétés telles que la hauteur de ligne. Par exemple, vous pouvez augmenter la hauteur de ligne par défaut afin de fournir un espace supplémentaire sous le contenu des cellules ordinaires pour afficher le contenu qui s’étend sur plusieurs colonnes.

La définition du modèle de ligne est nécessaire lorsque des données externes sont affichées à l’aide de types personnalisés dérivés de la DataGridViewRow classe . Avec les contrôles indépendants DataGridView , vous pouvez remplir la Rows collection par programmation avec des instances de votre type de ligne personnalisé. Toutefois, lors de l’affichage de données externes, les lignes sont générées automatiquement, mais elles sont basées sur le modèle de ligne, que vous pouvez définir sur une instance de votre type de ligne personnalisé.

Si cette propriété n’a pas été définie la première fois que vous récupérez sa valeur, une nouvelle DataGridViewRow propriété est créée et retournée.

S’applique à

Voir aussi