Compartilhar via


DataGridViewColumn.CellTemplate Propriedade

Definição

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 virtual System.Windows.Forms.DataGridViewCell CellTemplate { get; set; }
[System.ComponentModel.Browsable(false)]
public virtual System.Windows.Forms.DataGridViewCell? CellTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overridable Property CellTemplate As DataGridViewCell

Valor da propriedade

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

Atributos

Exemplos

O exemplo de código a seguir demonstra como usar um DataGridViewCell como modelo para um DataGridViewColumn. As alterações de estilo feitas em qualquer célula na coluna afetam todas as células da coluna. Este exemplo de código faz parte de um exemplo maior fornecido para a DataGridViewColumn classe .

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

Os construtores da DataGridViewColumn classe inicializam essa propriedade. O construtor sem parâmetros define a propriedade nullcomo ; o outro construtor copia o modelo de célula de seu parâmetro.

Observação

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 para o DataGridView.InvalidateColumn método ).

Aplica-se a

Confira também