Sdílet prostřednictvím

DataGridViewCheckBoxColumn.CellTemplate Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

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

Všechny DataGridViewCell 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 pro všechny buňky ve sloupci zaškrtávacího políčka. Tento příklad je součástí většího příkladu, který je k dispozici 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řenou DataGridViewCheckBoxCell.

Upozornění

Změna vlastností šablony buňky nebude mít okamžitě vliv na 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).

Platí pro

Viz také