DataGridViewButtonColumn.CellTemplate Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origem:: DataGridViewButtonColumn.cs

Origem:: DataGridViewButtonColumn.cs

Origem:: DataGridViewButtonColumn.cs

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 o modelo usado para criar novas células.

public:
 virtual property System::Windows::Forms::DataGridViewCell ^ CellTemplate { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };

[System.ComponentModel.Browsable(false)]
public override System.Windows.Forms.DataGridViewCell CellTemplate { get; set; }

[System.ComponentModel.Browsable(false)]
public override System.Windows.Forms.DataGridViewCell? CellTemplate { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set

Public Overrides Property CellTemplate As DataGridViewCell

Valor da propriedade

DataGridViewCell

Um DataGridViewCell depois do qual todas as outras células na coluna são modeladas.

Atributos: BrowsableAttribute

Exceções

InvalidCastException

O valor especificado quando a configuração dessa propriedade não pôde ser convertida em uma DataGridViewButtonCell.

Exemplos

O exemplo de código a seguir demonstra como usar um DataGridViewButtonColumn para exibir as vendas que um funcionário fez. Um modelo de célula é usado para aplicar a mesma cor a todos os botões. 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

O construtor da DataGridViewButtonColumn classe inicializa essa propriedade para um recém-criado DataGridViewButtonCell.

Cuidado

A alteração das propriedades do modelo de célula não afetará imediatamente a interface do usuário das células existentes da coluna. Essas alterações só são aparentes depois que a coluna é regenerada (por exemplo, classificando a coluna ou por meio de uma chamada para o DataGridView.InvalidateColumn método).

Aplica-se a

Partilhar via