DataGridViewButtonCell.UseColumnTextForButtonValue Property

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

Property Value

true if the value of the Value property will automatically match the value of the Text property of the owning column; otherwise, false. The default is false.

Examples

The following code example demonstrates the use of this member.

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

Remarks

The FormattedValue of a button cell is displayed as text on the button. The UseColumnTextForButtonValue property allows you to either set the button text for each cell, or to use the Text property value of the parent column for all of the button cells.

Setting the UseColumnTextForButtonValue property of the owning column also sets the UseColumnTextForButtonValue property of every cell in the column and refreshes the column display. To override the specified value for individual cells, set the cell values after you set the column value.

Applies to

See also

• DataGridView
• Value
• FormattedValue
• Text
• UseColumnTextForButtonValue