DataGridViewButtonColumn.Text Własność

Definicja

Namespace:

System.Windows.Forms

Montaż:

System.Windows.Forms.dll

Źródło:

DataGridViewButtonColumn.cs

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; }

member this.Text : string with get, set

Public Property Text As String

Wartość nieruchomoś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.

Zobacz także

• DataGridView
• DataGridViewButtonCell
• UseColumnTextForButtonValue
• UseColumnTextForButtonValue
• CellTemplate