Compartilhar via

DataGridViewButtonColumn.Text Propriedade

  • Referência

Definição

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

Obtém ou define o texto padrão exibido na célula do botão.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
public string Text { get; set; }
public string? Text { get; set; }
member this.Text : string with get, set
Public Property Text As String

Valor da propriedade

String

Um String que contém o texto. O padrão é Empty.

Exceções

InvalidOperationException

Ao definir essa propriedade, o valor da propriedade CellTemplate é null.

Exemplos

O exemplo de código a seguir demonstra como usar um DataGridViewButtonColumn para exibir as vendas que um funcionário fez. A Text propriedade é usada para definir o cabeçalho da coluna. Este exemplo faz parte de um exemplo maior disponível no tópico de visão geral da DataGridViewComboBoxColumn classe.

private:
    void AddButtonColumn()
    {
        DataGridViewButtonColumn^ buttons = gcnew DataGridViewButtonColumn();
        {
            buttons->HeaderText = "Sales";
            buttons->Text = "Sales";
            buttons->UseColumnTextForButtonValue = true;
            buttons->AutoSizeMode =
                DataGridViewAutoSizeColumnMode::AllCells;
            buttons->FlatStyle = FlatStyle::Standard;
            buttons->CellTemplate->Style->BackColor = Color::Honeydew;
            buttons->DisplayIndex = 0;
        }

        DataGridView1->Columns->Add(buttons);

    }

private void AddButtonColumn()
{
    DataGridViewButtonColumn buttons = new DataGridViewButtonColumn();
    {
        buttons.HeaderText = "Sales";
        buttons.Text = "Sales";
        buttons.UseColumnTextForButtonValue = true;
        buttons.AutoSizeMode =
            DataGridViewAutoSizeColumnMode.AllCells;
        buttons.FlatStyle = FlatStyle.Standard;
        buttons.CellTemplate.Style.BackColor = Color.Honeydew;
        buttons.DisplayIndex = 0;
    }

    DataGridView1.Columns.Add(buttons);
}

Private Sub AddButtonColumn()
    Dim buttons As New DataGridViewButtonColumn()
    With buttons
        .HeaderText = "Sales"
        .Text = "Sales"
        .UseColumnTextForButtonValue = True
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate.Style.BackColor = Color.Honeydew
        .DisplayIndex = 0
    End With

    DataGridView1.Columns.Add(buttons)

End Sub

Comentários

Cada DataGridViewButtonCell um contido na coluna que tem como um UseColumnTextForButtonValue valor de propriedade de true exibe o Text valor da propriedade no botão da célula.

Se houver um controle associado DataGridView , alterar essa propriedade atualizará a exibição da coluna.

Aplica-se a

Confira também