DataGridViewCheckBoxColumn.CellTemplate Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCheckBoxColumn.cs

Získá nebo nastaví šablonu použitou k vytvoření nových buněk.

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

Hodnota vlastnosti

DataGridViewCell

A DataGridViewCell , že všechny ostatní buňky ve sloupci jsou modelovány po. Výchozí hodnota je nová DataGridViewCheckBoxCell instance.

Atributy

BrowsableAttribute

Výjimky

InvalidCastException

Vlastnost je nastavena na hodnotu, která není typu DataGridViewCheckBoxCell.

Příklady

Následující příklad kódu ukazuje, jak použít DataGridViewCheckBoxColumn k označení zaměstnanců mimo kancelář. Šablona buňky slouží k použití stejné barvy u všech buněk ve sloupci zaškrtávacího políčka. Tento příklad je součástí většího příkladu dostupného v tématu přehledu DataGridViewComboBoxColumn třídy.

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

Poznámky

Konstruktory třídy DataGridViewCheckBoxColumn inicializují tuto vlastnost na nově vytvořený DataGridViewCheckBoxCell.

Caution

Změna vlastností šablony buňky okamžitě neovlivní uživatelské rozhraní existujících buněk sloupce. Tyto změny se projeví až po opětovném vygenerování sloupce (například řazením sloupce nebo voláním DataGridView.InvalidateColumn metody).

Viz také

• DataGridView
• DataGridViewCheckBoxColumn
• DataGridViewCell
• DataGridViewCheckBoxCell
• InvalidateColumn(Int32)