DataGridViewButtonColumn.UseColumnTextForButtonValue Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta un valore che indica se il valore della proprietà Text viene visualizzato come testo pulsante per le celle in questa colonna.

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

Valore della proprietà

Boolean

true se il valore della proprietà Text viene visualizzato sui pulsanti della colonna, false se il valore della proprietà FormattedValue di ciascuna cella viene visualizzato sul relativo pulsante. Il valore predefinito è false.

Eccezioni

InvalidOperationException

Il valore della proprietà CellTemplate è null.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questa proprietà.

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

Commenti

Per impostazione predefinita, la DataGridViewCell.FormattedValue cella di un pulsante viene visualizzata come testo sul pulsante. La UseColumnTextForButtonValue proprietà consente di impostare il testo del pulsante per ogni cella o di usare il Text valore della proprietà per tutte le celle del pulsante.

Ottenere o impostare questa proprietà ottiene o imposta la UseColumnTextForButtonValue proprietà dell'oggetto CellTemplate restituito dalla proprietà . L'impostazione di questa proprietà imposta anche la UseColumnTextForButtonValue proprietà di ogni cella nella colonna e aggiorna la visualizzazione della colonna. Per eseguire l'override del valore specificato per le singole celle, impostare i valori della cella dopo aver impostato il valore della colonna.

Si applica a

Vedi anche