DataGridViewCheckBoxColumn.CellTemplate Proprietà

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Origine:
DataGridViewCheckBoxColumn.cs
Origine:
DataGridViewCheckBoxColumn.cs
Origine:
DataGridViewCheckBoxColumn.cs
Origine:
DataGridViewCheckBoxColumn.cs
Origine:
DataGridViewCheckBoxColumn.cs

Ottiene o imposta il modello utilizzato per creare nuove celle.

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)]
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

Valore della proprietà

DataGridViewCell

Oggetto DataGridViewCell che tutte le altre celle della colonna vengono modellate dopo. Il valore predefinito è una nuova DataGridViewCheckBoxCell istanza.

Attributi
BrowsableAttribute

Eccezioni

InvalidCastException

La proprietà è impostata su un valore che non è di tipo DataGridViewCheckBoxCell.

Esempio

Nell'esempio di codice seguente viene illustrato come usare un DataGridViewCheckBoxColumn oggetto per contrassegnare i dipendenti fuori sede. Il modello di cella viene usato per applicare lo stesso colore a tutte le celle nella colonna della casella di controllo. Questo esempio fa parte di un esempio più ampio disponibile nell'argomento di panoramica della 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

Commenti

I costruttori per la DataGridViewCheckBoxColumn classe inizializzano questa proprietà in un oggetto appena creato DataGridViewCheckBoxCell.

Attenzione

La modifica delle proprietà del modello di cella non influirà immediatamente sull'interfaccia utente delle celle esistenti della colonna. Queste modifiche sono evidenti solo dopo la rigenerazione della colonna, ad esempio ordinando la colonna o tramite una chiamata al DataGridView.InvalidateColumn metodo .

Si applica a

Vedi anche