DataGridViewButtonColumn.CellTemplate Eigenschaft

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
DataGridViewButtonColumn.cs
Quelle:
DataGridViewButtonColumn.cs
Quelle:
DataGridViewButtonColumn.cs
Quelle:
DataGridViewButtonColumn.cs
Quelle:
DataGridViewButtonColumn.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.

Attribute
BrowsableAttribute

Ausnahmen

InvalidCastException

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein DataGridViewButtonColumn Mitarbeiter den Umsatz anzeigen kann, den 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 einer neu erstellten DataGridViewButtonCell.

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