Partilhar via

DataGridViewButtonColumn.UseColumnTextForButtonValue Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define um valor que indica se o valor da propriedade Text será exibido como o texto do botão para as células nesta coluna.

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 da propriedade

Boolean

true se o valor da propriedade Text for exibido nos botões na coluna; false se o valor da propriedade FormattedValue de cada célula for exibido em seu botão. O padrão é false.

Exceções

InvalidOperationException

O valor da propriedade CellTemplate é null.

Exemplos

O exemplo de código a seguir demonstra o uso dessa propriedade.

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

Comentários

Por padrão, a DataGridViewCell.FormattedValue célula de um botão é exibida como o texto no botão. A UseColumnTextForButtonValue propriedade permite que você defina o texto do botão para cada célula ou use o valor da Text propriedade para todas as células de botão.

Obter ou definir essa propriedade obtém ou define a UseColumnTextForButtonValue propriedade do objeto retornado pela CellTemplate propriedade. Definir essa propriedade também define a UseColumnTextForButtonValue propriedade de cada célula na coluna e atualiza a exibição da coluna. Para substituir o valor especificado para células individuais, defina os valores de célula depois de definir o valor da coluna.

Aplica-se a

Confira também