DataGridViewButtonColumn.UseColumnTextForButtonValue Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob der Text-Eigenschaftswert für Zellen in dieser Spalte als Schaltflächentext angezeigt wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn der Text-Eigenschaftswert auf Schaltflächen in der Spalte angezeigt wird; false, wenn der FormattedValue-Eigenschaftswert jeder Zelle auf der zugehörigen Schaltfläche angezeigt wird. Der Standardwert ist false.

Ausnahmen

InvalidOperationException

Der Wert der CellTemplate-Eigenschaft ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht.

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

Hinweise

Standardmäßig wird die DataGridViewCell.FormattedValue Zelle einer Schaltfläche als Text auf der Schaltfläche angezeigt. Mit UseColumnTextForButtonValue der Eigenschaft können Sie entweder den Schaltflächentext für jede Zelle festlegen oder den Text Eigenschaftswert für alle Schaltflächenzellen verwenden.

Abrufen oder Festlegen dieser Eigenschaft ruft die UseColumnTextForButtonValue Eigenschaft des von der CellTemplate Eigenschaft zurückgegebenen Objekts ab oder legt sie fest. Durch Festlegen dieser Eigenschaft wird auch die UseColumnTextForButtonValue Eigenschaft jeder Zelle in der Spalte festgelegt und die Spaltenanzeige aktualisiert. Um den angegebenen Wert für einzelne Zellen außer Kraft zu setzen, legen Sie die Zellwerte nach dem Festlegen des Spaltenwerts fest.

Gilt für