DataGridViewButtonColumn.UseColumnTextForButtonValue Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
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.