DataGridViewCheckBoxColumn.CellTemplate Propiedad

Definición

Obtiene o establece la plantilla utilizada para crear nuevas celdas.Gets or sets the template used to create new cells.

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

Valor de propiedad

Una celda DataGridViewCell según la cual se modelan todas las demás celdas de la columna.A DataGridViewCell that all other cells in the column are modeled after. El valor predeterminado es una nueva instancia de DataGridViewCheckBoxCell.The default value is a new DataGridViewCheckBoxCell instance.

Atributos

Excepciones

La propiedad se establece en un valor que no es de tipo DataGridViewCheckBoxCell.The property is set to a value that is not of type DataGridViewCheckBoxCell.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un DataGridViewCheckBoxColumn para marcar qué empleados están fuera de la oficina.The following code example demonstrates how to use a DataGridViewCheckBoxColumn to mark which employees are out of the office. La plantilla de celda se utiliza para aplicar el mismo color a todas las celdas de la columna de casilla.The cell template is used to apply the same color to all cells in the check box column. Este ejemplo forma parte de un ejemplo más grande disponible en el tema información general de la clase DataGridViewComboBoxColumn.This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

private:
    void AddOutOfOfficeColumn()
    {
        DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
        {
            column->HeaderText = ColumnName::OutOfOffice.ToString();
            column->Name = ColumnName::OutOfOffice.ToString();
            column->AutoSizeMode = 
                DataGridViewAutoSizeColumnMode::DisplayedCells;
            column->FlatStyle = FlatStyle::Standard;
            column->ThreeState = true;
            column->CellTemplate = gcnew DataGridViewCheckBoxCell();
            column->CellTemplate->Style->BackColor = Color::Beige;
        }

        DataGridView1->Columns->Insert(0, column);
    }
private void AddOutOfOfficeColumn()
{
    DataGridViewCheckBoxColumn column = new DataGridViewCheckBoxColumn();
    {
        column.HeaderText = ColumnName.OutOfOffice.ToString();
        column.Name = ColumnName.OutOfOffice.ToString();
        column.AutoSizeMode = 
            DataGridViewAutoSizeColumnMode.DisplayedCells;
        column.FlatStyle = FlatStyle.Standard;
        column.ThreeState = true;
        column.CellTemplate = new DataGridViewCheckBoxCell();
        column.CellTemplate.Style.BackColor = Color.Beige;
    }

    DataGridView1.Columns.Insert(0, column);
}
Private Sub AddOutOfOfficeColumn()
    Dim column As New DataGridViewCheckBoxColumn()
    With column
        .HeaderText = ColumnName.OutOfOffice.ToString()
        .Name = ColumnName.OutOfOffice.ToString()
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate = New DataGridViewCheckBoxCell()
        .CellTemplate.Style.BackColor = Color.Beige
    End With

    DataGridView1.Columns.Insert(0, column)
End Sub

Comentarios

Los constructores de la clase DataGridViewCheckBoxColumn inicializan esta propiedad en un DataGridViewCheckBoxCellrecién creado.The constructors for the DataGridViewCheckBoxColumn class initialize this property to a newly created DataGridViewCheckBoxCell.

Precaución

El cambio de las propiedades de la plantilla de celda no afectará de inmediato a la interfaz de usuario (UI) de las celdas existentes de la columna.Changing the properties of the cell template will not immediately affect the user interface (UI) of the column's existing cells. Estos cambios solo se muestran después de que se vuelva a generar la columna (por ejemplo, al ordenar la columna o a través de una llamada al método DataGridView.InvalidateColumn).These changes are only apparent after the column is regenerated (for example, by sorting the column or through a call to the DataGridView.InvalidateColumn method).

Se aplica a

Consulte también: