DataGridViewButtonCell.UseColumnTextForButtonValue Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob der Text der besitzenden Spalte auf der in der Zelle angezeigten Schaltfläche angezeigt wird.

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 Wert der Value-Eigenschaft automatisch mit dem Wert der Text-Eigenschaft der besitzenden Spalte in Übereinstimmung gebracht wird, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members 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

Der FormattedValue einer Schaltflächenzelle wird 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 der übergeordneten Spalte für alle Schaltflächenzellen verwenden.

Durch Festlegen der UseColumnTextForButtonValue -Eigenschaft der besitzenden Spalte 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 fest, nachdem Sie den Spaltenwert festgelegt haben.

Weitere Informationen

• DataGridView
• Value
• FormattedValue
• Text
• UseColumnTextForButtonValue