DataGridViewButtonColumn.Text Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta il testo predefinito visualizzato sulla cella pulsante.

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

Valore della proprietà

String

Oggetto String che contiene il testo. Il valore predefinito è Empty.

Eccezioni

InvalidOperationException

Quando si imposta questa proprietà, il valore della proprietà CellTemplate è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare un DataGridViewButtonColumn per visualizzare le vendite effettuate da un dipendente. La Text proprietà viene usata per impostare l'intestazione di colonna. Questo esempio fa parte di un esempio più ampio disponibile nell'argomento panoramica della DataGridViewComboBoxColumn classe.

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

Commenti

Ogni DataGridViewButtonCell oggetto contenuto nella colonna con come UseColumnTextForButtonValue valore true della proprietà visualizza il Text valore della proprietà sul pulsante della cella.

Se è presente un controllo associato DataGridView , la modifica di questa proprietà aggiorna la visualizzazione della colonna.

Si applica a