La clase DataGridViewCheckBoxColumn es un tipo especializado de la clase DataGridViewColumn usada para alojar lógicamente las celdas que indican un estado binario. Un elemento DataGridViewCheckBoxColumn tiene un elemento DataGridViewCheckBoxCell asociado en cada objeto DataGridViewRow entra en intersección con él. Cada celda proporciona una interfaz de usuario que es similar a un control CheckBox.

El modo de ordenación predeterminado de este tipo de columna es NotSortable.

Normalmente, los valores de celda de casilla de verificación están pensados para almacenamiento, como cualquier otro tipo de datos, o para realizar operaciones masivas. Si desea responder inmediatamente cuando los usuarios hacen clic en una celda de casilla de verificación, puede controlar el evento DataGridView..::.CellContentClick, pero este evento aparece antes de actualizar el valor de la celda. Si necesita el nuevo valor en el momento del clic, una opción es calcular cuál será el valor esperado basándose en el valor actual. Otro enfoque es confirmar inmediatamente el cambio y controlar el evento DataGridView..::.CellValueChanged para responder al mismo. Para confirmar el cambio cuando se hace clic en la celda, debe controlar el evento DataGridView..::.CurrentCellDirtyStateChanged. En el controlador, si la celda actual es una celda de casilla de verificación, llame al método DataGridView..::.CommitEdit y pase el valor Commit.

Cuando derive del control DataGridViewCheckBoxColumn y agregue nuevas propiedades a la clase derivada, asegúrese de reemplazar el método Clone para copiar las nuevas propiedades durante las operaciones de clonación. También debe llamar al método Clone de la clase base para que las propiedades de la clase base se copien a la nueva celda.

El ejemplo de código siguiente muestra cómo utilizar un objeto DataGridViewCheckBoxColumn para marcar qué empleados están fuera de la oficina. Este ejemplo forma parte de un ejemplo más extenso que está disponible en el tema de información general sobre la clase DataGridViewComboBoxColumn.

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

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:
    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);
    }

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework

Referencia