DataGridViewCheckBoxColumn.CellTemplate Eigenschaft

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
DataGridViewCheckBoxColumn.cs
Quelle:
DataGridViewCheckBoxColumn.cs
Quelle:
DataGridViewCheckBoxColumn.cs
Quelle:
DataGridViewCheckBoxColumn.cs
Quelle:
DataGridViewCheckBoxColumn.cs

Ruft die Vorlage ab, die zum Erstellen neuer Zellen verwendet wird, oder legt sie fest.

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)]
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

Eigenschaftswert

DataGridViewCell

A DataGridViewCell that all other cells in the column are modeled after. Der Standardwert ist eine neue DataGridViewCheckBoxCell Instanz.

Attribute
BrowsableAttribute

Ausnahmen

InvalidCastException

Die Eigenschaft wird auf einen Wert festgelegt, der nicht vom Typ ist DataGridViewCheckBoxCell.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit einer DataGridViewCheckBoxColumn Kennzeichnung versehen können, welche Mitarbeiter nicht im Büro sind. Die Zellenvorlage wird verwendet, um die gleiche Farbe auf alle Zellen in der Kontrollkästchenspalte anzuwenden. Dieses Beispiel ist Teil eines größeren Beispiels, das DataGridViewComboBoxColumn im Thema "Klassenübersicht" verfügbar ist.

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 in eine neu erstellte DataGridViewCheckBoxCell.

Vorsicht

Das Ändern der Eigenschaften der Zellenvorlage wirkt sich nicht sofort auf die Benutzeroberfläche der vorhandenen Zellen der Spalte aus. Diese Änderungen werden erst angezeigt, nachdem die Spalte neu generiert wurde (z. B. durch Sortieren der Spalte oder durch einen Aufruf der DataGridView.InvalidateColumn Methode).

Gilt für:

Weitere Informationen