DataGridViewButtonColumn.Text Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridViewButtonColumn.cs

Dient zum Abrufen oder Festlegen des Standardtexts, der in der Schaltflächenzelle angezeigt wird.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

public string? Text { get; set; }

member this.Text : string with get, set

Public Property Text As String

Eigenschaftswert

String

A String , das den Text enthält. Der Standardwert lautet Empty.

Ausnahmen

InvalidOperationException

Beim Festlegen dieser Eigenschaft lautet nullder Wert der CellTemplate Eigenschaft .

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein DataGridViewButtonColumn Mitarbeiter den Umsatz anzeigen kann, den ein Mitarbeiter getätigt hat. Die Text Eigenschaft wird verwendet, um die Spaltenüberschrift festzulegen. 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

Jede DataGridViewButtonCell in der Spalte enthaltene Spalte mit dem UseColumnTextForButtonValue Eigenschaftswert zeigt true den Text Eigenschaftswert auf der Schaltfläche der Zelle an.

Wenn ein zugeordnetes Steuerelement vorhanden DataGridView ist, wird durch Ändern dieser Eigenschaft die Spaltenanzeige aktualisiert.

Weitere Informationen

• DataGridView
• DataGridViewButtonCell
• UseColumnTextForButtonValue
• UseColumnTextForButtonValue
• CellTemplate