DataGridViewCheckBoxColumn.CellTemplate Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit le modèle utilisé pour créer des cellules.

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; }
[<System.ComponentModel.Browsable(false)>]
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overrides Property CellTemplate As DataGridViewCell

Valeur de propriété

DataGridViewCell

DataGridViewCell d'après lequel toutes les autres cellules de la colonne sont modelées. La valeur par défaut est une nouvelle instance de DataGridViewCheckBoxCell.

Attributs
BrowsableAttribute

Exceptions

InvalidCastException

La propriété a une valeur qui n'est pas de type DataGridViewCheckBoxCell.

Exemples

L’exemple de code suivant montre comment utiliser un DataGridViewCheckBoxColumn pour marquer les employés qui ne sont pas au bureau. Le modèle de cellule est utilisé pour appliquer la même couleur à toutes les cellules de la colonne de case à cocher. Cet exemple fait partie d’un exemple plus large disponible dans la rubrique vue d’ensemble de la DataGridViewComboBoxColumn classe.

private:
    void AddOutOfOfficeColumn()
    {
        DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
        {
            column->HeaderText = ColumnName::OutOfOffice.ToString();
            column->Name = ColumnName::OutOfOffice.ToString();
            column->AutoSizeMode = 
                DataGridViewAutoSizeColumnMode::DisplayedCells;
            column->FlatStyle = FlatStyle::Standard;
            column->ThreeState = true;
            column->CellTemplate = gcnew DataGridViewCheckBoxCell();
            column->CellTemplate->Style->BackColor = Color::Beige;
        }

        DataGridView1->Columns->Insert(0, column);
    }

private void AddOutOfOfficeColumn()
{
    DataGridViewCheckBoxColumn column = new DataGridViewCheckBoxColumn();
    {
        column.HeaderText = ColumnName.OutOfOffice.ToString();
        column.Name = ColumnName.OutOfOffice.ToString();
        column.AutoSizeMode = 
            DataGridViewAutoSizeColumnMode.DisplayedCells;
        column.FlatStyle = FlatStyle.Standard;
        column.ThreeState = true;
        column.CellTemplate = new DataGridViewCheckBoxCell();
        column.CellTemplate.Style.BackColor = Color.Beige;
    }

    DataGridView1.Columns.Insert(0, column);
}

Private Sub AddOutOfOfficeColumn()
    Dim column As New DataGridViewCheckBoxColumn()
    With column
        .HeaderText = ColumnName.OutOfOffice.ToString()
        .Name = ColumnName.OutOfOffice.ToString()
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate = New DataGridViewCheckBoxCell()
        .CellTemplate.Style.BackColor = Color.Beige
    End With

    DataGridView1.Columns.Insert(0, column)
End Sub

Remarques

Les constructeurs de la DataGridViewCheckBoxColumn classe initialisent cette propriété vers une nouvelle création DataGridViewCheckBoxCell.

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. Ces modifications sont visibles uniquement une fois la colonne régénérée (par exemple, en triant la colonne ou via un appel à la DataGridView.InvalidateColumn méthode).

S’applique à

Voir aussi