DataGridViewButtonColumn.CellTemplate Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Eine DataGridViewCell, nach der alle anderen Zellen in der Spalte erstellt werden.

Attribute: BrowsableAttribute

Ausnahmen

InvalidCastException

Der beim Festlegen dieser Eigenschaft angegebene Wert konnte nicht in eine DataGridViewButtonCell umgewandelt werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit einem DataGridViewButtonColumn die Verkäufe anzeigen, die ein Mitarbeiter getätigt hat. Eine Zellenvorlage wird verwendet, um die gleiche Farbe auf alle Schaltflächen anzuwenden. Dieses Beispiel ist Teil eines größeren Beispiels, das DataGridViewComboBoxColumn im Thema Klassenübersicht verfügbar ist.

private:
    void AddButtonColumn()
    {
        DataGridViewButtonColumn^ buttons = gcnew DataGridViewButtonColumn();
        {
            buttons->HeaderText = "Sales";
            buttons->Text = "Sales";
            buttons->UseColumnTextForButtonValue = true;
            buttons->AutoSizeMode =
                DataGridViewAutoSizeColumnMode::AllCells;
            buttons->FlatStyle = FlatStyle::Standard;
            buttons->CellTemplate->Style->BackColor = Color::Honeydew;
            buttons->DisplayIndex = 0;
        }

        DataGridView1->Columns->Add(buttons);

    }

private void AddButtonColumn()
{
    DataGridViewButtonColumn buttons = new DataGridViewButtonColumn();
    {
        buttons.HeaderText = "Sales";
        buttons.Text = "Sales";
        buttons.UseColumnTextForButtonValue = true;
        buttons.AutoSizeMode =
            DataGridViewAutoSizeColumnMode.AllCells;
        buttons.FlatStyle = FlatStyle.Standard;
        buttons.CellTemplate.Style.BackColor = Color.Honeydew;
        buttons.DisplayIndex = 0;
    }

    DataGridView1.Columns.Add(buttons);
}

Private Sub AddButtonColumn()
    Dim buttons As New DataGridViewButtonColumn()
    With buttons
        .HeaderText = "Sales"
        .Text = "Sales"
        .UseColumnTextForButtonValue = True
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate.Style.BackColor = Color.Honeydew
        .DisplayIndex = 0
    End With

    DataGridView1.Columns.Add(buttons)

End Sub

Hinweise

Der Konstruktor für die DataGridViewButtonColumn -Klasse initialisiert diese Eigenschaft in einem neu erstellten DataGridViewButtonCell.

Achtung

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

Gilt für: