DataGridViewCheckBoxColumn.CellTemplate Свойство

Определение

Получает или задает шаблон, используемый для создания новых ячеек.Gets or sets the template used to create new cells.

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; }
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overrides Property CellTemplate As DataGridViewCell

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

Ячейка DataGridViewCell, по которой моделируются все остальные ячейки в столбце.A DataGridViewCell that all other cells in the column are modeled after. Значением по умолчанию является новый экземпляр DataGridViewCheckBoxCell.The default value is a new DataGridViewCheckBoxCell instance.

Атрибуты

Исключения

Для свойства установлено значение, не принадлежащее типу DataGridViewCheckBoxCell.The property is set to a value that is not of type DataGridViewCheckBoxCell.

Примеры

В следующем примере кода показано, как использовать DataGridViewCheckBoxColumn для обозначения сотрудников, находящихся за пределами офиса.The following code example demonstrates how to use a DataGridViewCheckBoxColumn to mark which employees are out of the office. Шаблон ячейки используется для применения одного и того же цвета ко всем ячейкам в столбце флажков.The cell template is used to apply the same color to all cells in the check box column. Этот пример является частью большого примера, доступного в DataGridViewComboBoxColumn разделе Обзор класса.This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

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.The constructors for the DataGridViewCheckBoxColumn class initialize this property to a newly created DataGridViewCheckBoxCell.

Внимание!

Изменение свойств шаблона ячейки не будет немедленно влиять на пользовательский интерфейс существующих ячеек столбца.Changing the properties of the cell template will not immediately affect the user interface (UI) of the column's existing cells. Эти изменения очевидны только после повторного формирования столбца (например, путем сортировки столбца или вызова DataGridView.InvalidateColumn метода).These changes are only apparent after the column is regenerated (for example, by sorting the column or through a call to the DataGridView.InvalidateColumn method).

Применяется к

Дополнительно