DataGridViewCheckBoxColumn.CellTemplate DataGridViewCheckBoxColumn.CellTemplate DataGridViewCheckBoxColumn.CellTemplate DataGridViewCheckBoxColumn.CellTemplate Property

Definition

Ruft die zum Erstellen neuer Zellen verwendete Vorlage ab oder legt diese fest.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

Eigenschaftswert

Eine DataGridViewCell, nach der alle anderen Zellen in der Spalte erstellt werden.A DataGridViewCell that all other cells in the column are modeled after. Der Standardwert ist eine neue Instanz von DataGridViewCheckBoxCell.The default value is a new DataGridViewCheckBoxCell instance.

Ausnahmen

Die Eigenschaft wird auf einen Wert festgelegt, der nicht vom Typ DataGridViewCheckBoxCell ist.The property is set to a value that is not of type DataGridViewCheckBoxCell.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie verwendet DataGridViewCheckBoxColumn wird, um zu kennzeichnen, welche Mitarbeiter sich außerhalb des Büros befinden.The following code example demonstrates how to use a DataGridViewCheckBoxColumn to mark which employees are out of the office. Die Zellen Vorlage wird verwendet, um die gleiche Farbe auf alle Zellen in der Kontrollkästchen Spalte anzuwenden.The cell template is used to apply the same color to all cells in the check box column. Dieses Beispiel ist Teil eines größeren Beispiels, das im Thema DataGridViewComboBoxColumn Übersicht über die Klasse verfügbar ist.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

Hinweise

Die Konstruktoren für die DataGridViewCheckBoxColumn -Klasse initialisieren diese Eigenschaft für ein neu DataGridViewCheckBoxCellerstelltes-Objekt.The constructors for the DataGridViewCheckBoxColumn class initialize this property to a newly created DataGridViewCheckBoxCell.

Achtung

Das Ändern der Eigenschaften der Zellen Vorlage wirkt sich nicht direkt auf die Benutzeroberfläche (UI) der vorhandenen Zellen der Spalte aus.Changing the properties of the cell template will not immediately affect the user interface (UI) of the column's existing cells. Diese Änderungen sind nur offensichtlich, nachdem die Spalte erneut generiert wurde (z. b. durchsortieren der Spalte oder durch einen DataGridView.InvalidateColumn aufrufungsmethode).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).

Gilt für:

Siehe auch