DataGridViewCheckBoxColumn.CellTemplate Propiedad

  • Referencia

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

Una celda DataGridViewCell según la cual se modelan todas las demás celdas de la columna. El valor predeterminado es una nueva instancia de DataGridViewCheckBoxCell.

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 para DataGridViewCheckBoxColumn 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.

Precaución

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 son evidentes después de que se vuelva 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