DataGridViewButtonColumn.Text Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia domyślny tekst wyświetlany w komórce przycisku.

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

Wartość właściwości

String

Element String zawierający tekst. Wartość domyślna to Empty.

Wyjątki

InvalidOperationException

Podczas ustawiania tej właściwości wartość CellTemplate właściwości to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać elementu DataGridViewButtonColumn do wyświetlania sprzedaży wykonanej przez pracownika. Właściwość Text służy do ustawiania nagłówka kolumny. Ten przykład jest częścią większego przykładu dostępnego DataGridViewComboBoxColumn w temacie przeglądu klasy.

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

Uwagi

Każda DataGridViewButtonCell z nich zawarta w kolumnie, która ma wartość UseColumnTextForButtonValue właściwości w postaci właściwości, true wyświetla Text wartość właściwości na przycisku komórki.

Jeśli istnieje skojarzona DataGridView kontrolka, zmiana tej właściwości spowoduje odświeżenie wyświetlania kolumny.

Dotyczy