DataGridViewCheckBoxColumn.CellTemplate プロパティ

定義

新しいセルの作成に使用するテンプレートを取得または設定します。

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 の新しいインスタンスです。

属性

例外

プロパティが DataGridViewCheckBoxCell 型でない値に設定されています。

次のコード例では、a を使用 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された値に初期化します。

注意事項

セル テンプレートのプロパティを変更すると、列の既存のセルのユーザー インターフェイス (UI) にすぐには影響しません。 これらの変更は、列が再生成された後でのみ明らかになります (たとえば、列の並べ替えやメソッドの DataGridView.InvalidateColumn 呼び出しによって)。

適用対象

こちらもご覧ください