DataGridViewButtonColumn.Text Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
DataGridViewButtonColumn.cs
Origem:
DataGridViewButtonColumn.cs
Origem:
DataGridViewButtonColumn.cs
Origem:
DataGridViewButtonColumn.cs
Origem:
DataGridViewButtonColumn.cs

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 de Propriedade

String

A String que contém o texto. A predefinição é Empty.

Exceções

InvalidOperationException

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

Exemplos

O exemplo de código seguinte demonstra como usar a DataGridViewButtonColumn para visualizar as vendas que um colaborador realizou. A Text propriedade é usada para definir o cabeçalho da coluna. Este exemplo faz parte de um exemplo mais amplo disponível no DataGridViewComboBoxColumn tópico de visão geral da aula.

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

Observações

Cada uma DataGridViewButtonCell contida na coluna que tem como UseColumnTextForButtonValue valor de propriedade de true apresenta o Text valor da propriedade no botão da célula.

Se existir um controlo associado DataGridView , alterar esta propriedade atualiza o ecrã da coluna.

Aplica-se a

Ver também