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

プロパティ値

列に含まれる他のすべてのセルがモデルとする DataGridViewCellA 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.

注意事項

セルテンプレートのプロパティを変更しても、列の既存のセルのユーザーインターフェイス (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).

適用対象

こちらもご覧ください