DataGridViewColumn.CellTemplate Propriedade

Definição

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

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)>]
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overridable Property CellTemplate As DataGridViewCell

Valor de Propriedade

DataGridViewCell

A DataGridViewCell que todas as outras células da coluna são modeladas. A predefinição é null.

Atributos
BrowsableAttribute

Exemplos

O seguinte exemplo de código demonstra como usar a DataGridViewCell como modelo para um DataGridViewColumn. As alterações de estilo feitas a qualquer célula da 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

Observações

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

Note

Alterar as propriedades do modelo de célula não afetará imediatamente a interface do utilizador (UI) das células existentes da coluna. Estas alterações só são aparentes depois de a coluna ser regenerada (por exemplo, ordenando a coluna ou através de uma chamada ao DataGridView.InvalidateColumn método).

Aplica-se a

Ver também