DataGridViewCheckBoxColumn.CellTemplate Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia szablon używany do tworzenia nowych komórek.

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

Wartość właściwości

DataGridViewCell

Wszystkie DataGridViewCell pozostałe komórki w kolumnie są modelowane po. Wartość domyślna to nowe DataGridViewCheckBoxCell wystąpienie.

Atrybuty
BrowsableAttribute

Wyjątki

InvalidCastException

Właściwość jest ustawiona na wartość, która nie jest typu DataGridViewCheckBoxCell.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać obiektu , DataGridViewCheckBoxColumn aby oznaczyć pracowników, którzy są poza biurem. Szablon komórki służy do stosowania tego samego koloru do wszystkich komórek w kolumnie pola wyboru. Ten przykład jest częścią większego przykładu dostępnego w temacie DataGridViewComboBoxColumn przeglądu klasy.

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

Uwagi

Konstruktory klasy inicjują DataGridViewCheckBoxColumn tę właściwość do nowo utworzonego obiektu DataGridViewCheckBoxCell.

Przestroga

Zmiana właściwości szablonu komórki nie wpłynie natychmiast na interfejs użytkownika (UI) istniejących komórek kolumny. Te zmiany są widoczne tylko po wygenerowaniu kolumny (na przykład przez posortowanie kolumny lub wywołanie DataGridView.InvalidateColumn metody).

Dotyczy

Zobacz też