DataGridViewButtonColumn.Text Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewButtonColumn.cs

Obtient ou définit le texte par défaut affiché sur la cellule du bouton.

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

Valeur de propriété

String

Qui String contient le texte. La valeur par défaut est Empty.

Exceptions

InvalidOperationException

Lors de la définition de cette propriété, la valeur de la CellTemplate propriété est null.

Exemples

L’exemple de code suivant montre comment utiliser un DataGridViewButtonColumn pour afficher les ventes qu’un employé a effectuées. La Text propriété est utilisée pour définir l’en-tête de colonne. Cet exemple fait partie d’un exemple plus large disponible dans la rubrique vue d’ensemble de la 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

Remarques

Chacune DataGridViewButtonCell contenue dans la colonne qui a comme UseColumnTextForButtonValue valeur de propriété affiche la Text valeur de true propriété sur le bouton de la cellule.

S’il existe un contrôle associé DataGridView , la modification de cette propriété actualise l’affichage des colonnes.

Voir aussi

• DataGridView
• DataGridViewButtonCell
• UseColumnTextForButtonValue
• UseColumnTextForButtonValue
• CellTemplate