DataGridViewLinkColumn.CellTemplate Propriété

Définition

Obtient ou définit le modèle utilisé pour créer des cellules.Gets or sets the template used to create new cells.

public:
 virtual property System::Windows::Forms::DataGridViewCell ^ CellTemplate { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };
[System.ComponentModel.Browsable(false)]
public override System.Windows.Forms.DataGridViewCell CellTemplate { get; set; }
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overrides Property CellTemplate As DataGridViewCell

Valeur de propriété

DataGridViewCell d'après lequel toutes les autres cellules de la colonne sont modelées.A DataGridViewCell that all other cells in the column are modeled after. La valeur par défaut est une nouvelle instance de DataGridViewLinkCell.The default value is a new DataGridViewLinkCell instance.

Attributs

Exceptions

Lors de l'affectation d'une valeur qui n'est pas de type DataGridViewLinkCell à cette propriété.When setting this property to a value that is not of type DataGridViewLinkCell.

Exemples

L’exemple de code suivant montre comment utiliser un DataGridViewCell comme modèle pour un DataGridViewColumn.The following code example demonstrates how to use a DataGridViewCell as a template for a DataGridViewColumn. Les modifications de style apportées à une cellule dans la colonne affectent toutes les cellules de la colonne.Style changes made to any cell in the column affect all of the column's cells. Cet exemple de code fait partie d’un exemple plus complet fourni pour la classe DataGridViewColumn.This code example is part of a larger example provided for the DataGridViewColumn class.

void CustomizeCellsInThirdColumn()
{
   int thirdColumn = 2;
   DataGridViewColumn^ column = dataGridView->Columns[ thirdColumn ];
   DataGridViewCell^ cell = gcnew DataGridViewTextBoxCell;
   cell->Style->BackColor = Color::Wheat;
   column->CellTemplate = cell;
}


private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}
Private Sub CustomizeCellsInThirdColumn()

    Dim thirdColumn As Integer = 2
    Dim column As DataGridViewColumn = _
        dataGridView.Columns(thirdColumn)
    Dim cell As DataGridViewCell = _
        New DataGridViewTextBoxCell()

    cell.Style.BackColor = Color.Wheat
    column.CellTemplate = cell
End Sub

Remarques

Le constructeur de la classe DataGridViewLinkColumn initialise cette propriété à un DataGridViewLinkCellrécemment créé.The constructor for the DataGridViewLinkColumn class initializes this property to a newly created DataGridViewLinkCell.

Attention

La modification des propriétés du modèle de cellule n’affecte pas immédiatement l’interface utilisateur des cellules existantes de la colonne.Changing the properties of the cell template will not immediately affect the user interface (UI) of the column's existing cells. Ces modifications sont apparentes uniquement après la régénération de la colonne (par exemple, en triant la colonne ou via un appel à la méthode DataGridView.InvalidateColumn).These changes are only apparent after the column is regenerated (for example, by sorting the column or through a call to the DataGridView.InvalidateColumn method).

S’applique à

Voir aussi