DataGridViewCheckBoxColumn.CellTemplate Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta il modello usato per la creazione di 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)>]
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overrides Property CellTemplate As DataGridViewCell

Valore della proprietà

DataGridViewCell

Oggetto DataGridViewCell in base al quale sono modellate tutte le altre celle della colonna. Il valore predefinito è rappresentato da una nuova istanza della classe DataGridViewCheckBoxCell.

Attributi
BrowsableAttribute

Eccezioni

InvalidCastException

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

Esempio

Nell'esempio di codice seguente viene illustrato come usare un DataGridViewCheckBoxColumn oggetto per contrassegnare i dipendenti che si trovano all'esterno dell'ufficio. 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 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 classe inizializzano questa DataGridViewCheckBoxColumn proprietà in un oggetto appena creato DataGridViewCheckBoxCell.

Attenzione

La modifica delle proprietà del modello di cella non influisce 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