Freigeben über


DataGridViewButtonColumn.CellTemplate Eigenschaft

Definition

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

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

Attribute

Ausnahmen

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:

Weitere Informationen