DataGridViewButtonColumn.UseColumnTextForButtonValue Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si el valor de la propiedad Text se muestra como el texto del botón para las celdas de esta columna.

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

Valor de propiedad

Boolean

true si el valor de la propiedad Text se muestra en los botones de la columna; es false si en su botón se muestra el valor de la propiedad FormattedValue de cada celda. De manera predeterminada, es false.

Excepciones

InvalidOperationException

El valor de la propiedad CellTemplate es null.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta propiedad.

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

Comentarios

De forma predeterminada, la DataGridViewCell.FormattedValue de una celda de botón se muestra como el texto del botón. La UseColumnTextForButtonValue propiedad permite establecer el texto del botón para cada celda o usar el valor de propiedad Text para todas las celdas del botón.

Obtener o establecer esta propiedad obtiene o establece la UseColumnTextForButtonValue propiedad del objeto devuelto por la CellTemplate propiedad . Al establecer esta propiedad también se establece la UseColumnTextForButtonValue propiedad de cada celda de la columna y se actualiza la presentación de columnas. Para invalidar el valor especificado para celdas individuales, establezca los valores de celda después de establecer el valor de columna.

Consulte también

• DataGridView
• Text
• FormattedValue
• CellTemplate
• DataGridViewButtonCell
• UseColumnTextForButtonValue
• Procedimiento para deshabilitar botones en una columna de botones del control DataGridView de formularios Windows Forms