DataGridViewTextBoxColumn.CellTemplate Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 a aparência de célula do modelo.

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)>]
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 tipo de conjunto não é compatível com o tipo DataGridViewTextBoxCell.

Exemplos

O exemplo de código a seguir demonstra o uso da DataGridViewColumn.CellTemplate propriedade, que é semelhante a essa propriedade. Este exemplo faz parte de um exemplo maior disponível em How to: Manipulate Columns in the Windows Forms DataGridView Control.

void CustomizeCellsInThirdColumn()
{
   int thirdColumn = 2;
   DataGridViewColumn^ column = dataGridView->Columns[ thirdColumn ];
   DataGridViewCell^ cell = gcnew DataGridViewTextBoxCell;
   cell->Style->BackColor = Color::Wheat;
   column->CellTemplate = cell;
}

private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}

Private Sub CustomizeCellsInThirdColumn()

    Dim thirdColumn As Integer = 2
    Dim column As DataGridViewColumn = _
        dataGridView.Columns(thirdColumn)
    Dim cell As DataGridViewCell = _
        New DataGridViewTextBoxCell()

    cell.Style.BackColor = Color.Wheat
    column.CellTemplate = cell
End Sub

Comentários

O construtor da DataGridViewTextBoxColumn classe inicializa essa propriedade para um recém-criado DataGridViewTextBoxCell.

Cuidado

Alterar as 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 ao DataGridView.InvalidateColumn método).

Aplica-se a

Compartilhar via