DataGridViewButtonColumn.UseColumnTextForButtonValue Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si la valeur de la propriété Text est affichée comme texte du bouton pour les cellules dans cette colonne.

public:
 property bool UseColumnTextForButtonValue { bool get(); void set(bool value); };
public bool UseColumnTextForButtonValue { get; set; }
member this.UseColumnTextForButtonValue : bool with get, set
Public Property UseColumnTextForButtonValue As Boolean

Valeur de propriété

Boolean

true si la valeur de la propriété Text est affichée dans les boutons de la colonne ; false si la valeur de la propriété FormattedValue de chaque cellule est affichée dans son bouton. La valeur par défaut est false.

Exceptions

InvalidOperationException

La propriété CellTemplate possède la valeur null.

Exemples

L’exemple de code suivant illustre l’utilisation de cette propriété.

private void CreateUnboundButtonColumn()
{
    // Initialize the button column.
    DataGridViewButtonColumn buttonColumn =
        new DataGridViewButtonColumn();
    buttonColumn.Name = "Details";
    buttonColumn.HeaderText = "Details";
    buttonColumn.Text = "View Details";

    // Use the Text property for the button text for all cells rather
    // than using each cell's value as the text for its own button.
    buttonColumn.UseColumnTextForButtonValue = true;

    // Add the button column to the control.
    dataGridView1.Columns.Insert(0, buttonColumn);
}

Private Sub CreateUnboundButtonColumn()

    ' Initialize the button column.
    Dim buttonColumn As New DataGridViewButtonColumn

    With buttonColumn
        .HeaderText = "Details"
        .Name = "Details"
        .Text = "View Details"

        ' Use the Text property for the button text for all cells rather
        ' than using each cell's value as the text for its own button.
        .UseColumnTextForButtonValue = True
    End With

    ' Add the button column to the control.
    dataGridView1.Columns.Insert(0, buttonColumn)

End Sub

Remarques

Par défaut, le DataGridViewCell.FormattedValue d’une cellule de bouton s’affiche sous forme de texte sur le bouton. La UseColumnTextForButtonValue propriété vous permet de définir le texte du bouton pour chaque cellule ou d’utiliser la valeur de la Text propriété pour toutes les cellules de bouton.

L’obtention ou la définition de cette propriété obtient ou définit la UseColumnTextForButtonValue propriété de l’objet retourné par la CellTemplate propriété . La définition de cette propriété définit également la UseColumnTextForButtonValue propriété de chaque cellule de la colonne et actualise l’affichage des colonnes. Pour remplacer la valeur spécifiée pour les cellules individuelles, définissez les valeurs de cellule après avoir défini la valeur de colonne.

S’applique à

Voir aussi