DataGridViewButtonColumn.Text 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 den Standardtext ab, der in der Schaltflächenzelle angezeigt wird, oder legt diesen fest.

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

public string Text { get; set; }

public string? Text { get; set; }

member this.Text : string with get, set

Public Property Text As String

Eigenschaftswert

String

Eine String, die den Text enthält. Der Standardwert ist Empty.

Ausnahmen

InvalidOperationException

Wenn diese Eigenschaft festgelegt wird, ist der Wert der CellTemplate-Eigenschaft null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe von die DataGridViewButtonColumn Umsätze anzeigen, die ein Mitarbeiter erzielt hat. Die Text -Eigenschaft wird verwendet, um die Spaltenüberschrift festzulegen. Dieses Beispiel ist Teil eines größeren Beispiels, das im Thema Klassenübersicht DataGridViewComboBoxColumn 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, die als UseColumnTextForButtonValue Eigenschaftswert von true enthält, zeigt den Text Eigenschaftswert auf der Schaltfläche der Zelle an.

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

Gilt für: