DataGridViewCheckBoxColumn.CellTemplate Propiedad

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece la plantilla utilizada para crear nuevas celdas.

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 de propiedad

DataGridViewCell

Que DataGridViewCell todas las demás celdas de la columna se modelan después. El valor predeterminado es una nueva DataGridViewCheckBoxCell instancia.

Atributos
BrowsableAttribute

Excepciones

InvalidCastException

La propiedad se establece en un valor que no es de tipo 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. La plantilla de celda se usa para aplicar el mismo color a todas las celdas de la columna de casilla. Este ejemplo forma parte de un ejemplo más grande disponible en el tema de información general de la DataGridViewComboBoxColumn clase.

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 DataGridViewCheckBoxColumn clase inicializan esta propiedad en un objeto recién creado DataGridViewCheckBoxCell.

Caution

Cambiar las propiedades de la plantilla de celda no afectará inmediatamente a la interfaz de usuario (UI) de las celdas existentes de la columna. Estos cambios solo se muestran después de volver a generar la columna (por ejemplo, ordenando la columna o a través de una llamada al DataGridView.InvalidateColumn método ).

Se aplica a

Consulte también