DataGridViewCheckBoxColumn.CellTemplate 속성


셀을 새로 만드는 데 사용되는 템플릿을 가져오거나 설정합니다.Gets or sets the template used to create new cells.

 virtual property System::Windows::Forms::DataGridViewCell ^ CellTemplate { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };
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.

    void AddOutOfOfficeColumn()
        DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
            column->HeaderText = ColumnName::OutOfOffice.ToString();
            column->Name = ColumnName::OutOfOffice.ToString();
            column->AutoSizeMode = 
            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 = 
        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.


셀 템플릿의 속성을 변경 해도 열의 기존 셀의 사용자 인터페이스 (UI) 즉시 영향을 주지 않습니다.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).

적용 대상

추가 정보