DataGridViewCheckBoxColumn.CellTemplate Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает шаблон, используемый для создания ячеек.

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

Значение свойства

DataGridViewCell

Ячейка DataGridViewCell, по которой моделируются все остальные ячейки в столбце. Значением по умолчанию является новый экземпляр DataGridViewCheckBoxCell.

Атрибуты

BrowsableAttribute

Исключения

InvalidCastException

Для свойства установлено значение, не принадлежащее типу DataGridViewCheckBoxCell.

Примеры

В следующем примере кода показано, как использовать метку DataGridViewCheckBoxColumn того, какие сотрудники находятся вне офиса. Шаблон ячейки используется для применения одного цвета ко всем ячейкам в столбце флажка. Этот пример является частью более крупного примера, доступного в DataGridViewComboBoxColumn разделе обзора класса.

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

Комментарии

Конструкторы класса инициализируют DataGridViewCheckBoxColumn это свойство только что созданному DataGridViewCheckBoxCellобъекту.

Внимание!

Изменение свойств шаблона ячейки не сразу повлияет на пользовательский интерфейс существующих ячеек столбца. Эти изменения очевидны только после повторного создания столбца (например, путем сортировки столбца или вызова DataGridView.InvalidateColumn метода).

См. также раздел

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