DataGridViewCheckBoxCell Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Muestra una interfaz de usuario con apariencia de casilla para su uso en un control DataGridView.

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell

public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

Herencia

Object

DataGridViewElement

DataGridViewCell

DataGridViewCheckBoxCell

Implementaciones

IDataGridViewEditingCell

Ejemplos

En el ejemplo de código siguiente se usa un DataGridViewCheckBoxColumn para realizar un seguimiento de los empleados que están en la oficina. La columna se compone de DataGridViewCheckBoxCell objetos . 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

La DataGridViewCheckBoxCell clase es un tipo especializado de DataGridViewCell utilizado para mostrar información binaria o ternaria presentada a través de una interfaz de usuario de casilla. En el modo binario predeterminado, las celdas pueden contener valores de true o false. En modo ternario, las celdas toman uno de los CheckState valores. La ThreeState propiedad determina si el modo binario o ternario está en vigor.

DataGridViewCheckBoxColumn es el tipo de columna especializado para contener celdas de este tipo. De forma predeterminada, DataGridViewCheckBoxColumn.CellTemplate se inicializa en un nuevo DataGridViewCheckBoxCell. Para configurar las celdas de una columna después de una existente DataGridViewCheckBoxCell, establezca la propiedad de CellTemplate la columna en la celda que se va a usar como patrón.

Las propiedades relacionadas con la celda de la columna son contenedores para las propiedades con nombre similar de la celda de plantilla. Cambiar los valores de propiedad de la celda de plantilla solo afectará a las celdas basadas en la plantilla que se agregan después del cambio. Sin embargo, al cambiar los valores de propiedad relacionados con la celda de la columna, se actualizará la celda de plantilla y todas las demás celdas de la columna y se actualizará la presentación de la columna si es necesario.

Cuando la celda actual es , DataGridViewCheckBoxCellla DataGridView.IsCurrentCellInEditMode propiedad siempre truees .

Normalmente, los valores de una celda de casilla están diseñados para el almacenamiento, como cualquier otro dato, o para realizar operaciones masivas. Si quiere responder inmediatamente cuando los usuarios hacen clic en una celda de casilla, puede controlar el evento DataGridView.CellClick, pero este evento se produce 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 a partir del valor actual. Otro enfoque consiste en confirmar el cambio inmediatamente y controlar el evento DataGridView.CellValueChanged para responder a él. Para confirmar el cambio cuando se hace clic en la celda, tiene que controlar el evento DataGridView.CurrentCellDirtyStateChanged. En el controlador, si la celda actual es una celda de casilla, llame al método DataGridView.CommitEdit y pase el valor Commit.

Notas a los desarrolladores de herederos

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

Constructores

DataGridViewCheckBoxCell()	Inicializa una nueva instancia de la clase DataGridViewCheckBoxCell en su estado predeterminado.
DataGridViewCheckBoxCell(Boolean)	Inicializa una nueva instancia de la clase DataGridViewCheckBoxCell, habilitando el estado binario o ternario.

Propiedades

AccessibilityObject	Obtiene el objeto DataGridViewCell.DataGridViewCellAccessibleObject asignado a DataGridViewCell. (Heredado de DataGridViewCell)
ColumnIndex	Obtiene el índice de columna de esta celda. (Heredado de DataGridViewCell)
ContentBounds	Obtiene el rectángulo delimitador que rodea el área de contenido de la celda. (Heredado de DataGridViewCell)
ContextMenuStrip	Obtiene o establece el menú contextual asociado a la celda. (Heredado de DataGridViewCell)
DataGridView	Obtiene el control DataGridView asociado a este elemento. (Heredado de DataGridViewElement)
DefaultNewRowValue	Obtiene el valor predeterminado de una celda de la fila de nuevos registros. (Heredado de DataGridViewCell)
Displayed	Obtiene un valor que indica si la celda se muestra actualmente en pantalla. (Heredado de DataGridViewCell)
EditedFormattedValue	Obtiene el valor actual con formato de la celda, con independencia de si la celda está en modo de edición y no se ha confirmado el valor. (Heredado de DataGridViewCell)
EditingCellFormattedValue	Obtiene o establece el valor con formato del control hospedado por la celda cuando está en modo de edición.
EditingCellValueChanged	Obtiene o establece un marcador de que el valor de esta celda ha cambiado.
EditType	Obtiene el tipo del control de edición hospedado de la celda.
ErrorIconBounds	Obtiene los límites del icono de error para la celda. (Heredado de DataGridViewCell)
ErrorText	Obtiene o establece el texto que describe una condición de error asociada a la celda. (Heredado de DataGridViewCell)
FalseValue	Obtiene o establece el valor subyacente que corresponde a un valor de celda de false.
FlatStyle	Obtiene o establece la apariencia de estilo plano de la interfaz de usuario de casilla.
FormattedValue	Obtiene el valor de la celda con el formato para mostrar. (Heredado de DataGridViewCell)
FormattedValueType	Obtiene el tipo del valor de presentación de la celda.
Frozen	Obtiene un valor que indica si la celda está inmovilizada. (Heredado de DataGridViewCell)
HasStyle	Obtiene un valor que indica si se ha establecido la propiedad Style. (Heredado de DataGridViewCell)
IndeterminateValue	Obtiene o establece el valor subyacente que corresponde a un valor de celda indeterminado o null.
InheritedState	Obtiene el estado actual de la celda tal como lo hereda del estado de su fila y columna. (Heredado de DataGridViewCell)
InheritedStyle	Obtiene el estilo aplicado actualmente a la celda. (Heredado de DataGridViewCell)
IsInEditMode	Obtiene un valor que indica si actualmente se está editando la celda. (Heredado de DataGridViewCell)
OwningColumn	Obtiene la columna que contiene esta celda. (Heredado de DataGridViewCell)
OwningRow	Obtiene la fila que contiene esta celda. (Heredado de DataGridViewCell)
PreferredSize	Obtiene el tamaño, en píxeles, de un área rectangular en la que cabe la celda. (Heredado de DataGridViewCell)
ReadOnly	Obtiene o establece un valor que indica si se pueden editar los datos de la celda. (Heredado de DataGridViewCell)
Resizable	Obtiene un valor que indica si se puede cambiar el tamaño de la celda. (Heredado de DataGridViewCell)
RowIndex	Obtiene el índice de la fila primaria de la celda. (Heredado de DataGridViewCell)
Selected	Obtiene o establece un valor que indica si se ha seleccionado la celda. (Heredado de DataGridViewCell)
Size	Obtiene el tamaño de la celda. (Heredado de DataGridViewCell)
State	Obtiene el estado de la interfaz de usuario del elemento. (Heredado de DataGridViewElement)
Style	Obtiene o establece el estilo de la celda. (Heredado de DataGridViewCell)
Tag	Obtiene o establece el objeto que contiene datos complementarios sobre la celda. (Heredado de DataGridViewCell)
ThreeState	Obtiene o establece un valor que indica si el modo ternario se ha habilitado para el control de casilla hospedado.
ToolTipText	Obtiene o establece el texto de información sobre herramientas asociado a esta celda. (Heredado de DataGridViewCell)
TrueValue	Obtiene o establece el valor subyacente que corresponde a un valor de celda de true.
Value	Obtiene o establece el valor asociado a esta celda. (Heredado de DataGridViewCell)
ValueType	Obtiene el tipo de datos de los valores de la celda.
Visible	Obtiene un valor que indica si la celda está en una fila o columna que se ha ocultado. (Heredado de DataGridViewCell)

Métodos

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica el estilo de borde de celda de entrada según los criterios especificados. (Heredado de DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Devuelve un objeto Rectangle que representa el ancho de todos los márgenes de la celda. (Heredado de DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda dejará de estar compartida al hacer clic en la celda. (Heredado de DataGridViewCell)
Clone()	Crea una copia exacta de esta celda.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica si dejará de compartirse la fila que contiene la celda cuando se haga clic en el contenido de la celda.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica si dejará de compartirse la fila que contiene la celda cuando se haga doble clic en el contenido de la celda.
CreateAccessibilityInstance()	Crea un nuevo objeto accesible para el control DataGridViewCheckBoxCell.
DetachEditingControl()	Quita el control de edición de la celda de DataGridView. (Heredado de DataGridViewCell)
Dispose()	Libera todos los recursos que usa DataGridViewCell. (Heredado de DataGridViewCell)
Dispose(Boolean)	Libera los recursos no administrados que usa DataGridViewCell y, de forma opcional, libera los recursos administrados. (Heredado de DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda dejará de estar compartida al hacer doble clic en la celda. (Heredado de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indica si la fila primaria va a dejar de estar compartida cuando el foco se desplace a la celda. (Heredado de DataGridViewCell)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera el valor con formato de la celda que copiar en el Clipboard. (Heredado de DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Devuelve el rectángulo delimitador que rodea el área de contenido de la celda, que se calcula mediante la clase Graphics y el estilo de celda especificados.
GetContentBounds(Int32)	Devuelve el rectángulo delimitador que rodea el área de contenido de la celda utilizando un objeto Graphics predeterminado y el estilo de celda actualmente en vigor para la celda. (Heredado de DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Devuelve el valor actual con formato de la celda, con independencia de si la celda está en modo de edición y no se ha confirmado el valor. (Heredado de DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)	Obtiene el valor con formato de la celda mientras está en modo de edición.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Devuelve el rectángulo delimitador que rodea el icono de error de la celda, si se está mostrando.
GetErrorText(Int32)	Devuelve una cadena que representa el error para la celda. (Heredado de DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Obtiene el valor con formato de los datos de la celda.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetInheritedContextMenuStrip(Int32)	Obtiene el menú contextual heredado para la celda actual. (Heredado de DataGridViewCell)
GetInheritedState(Int32)	Devuelve un valor que indica el estado actual de la celda tal como lo hereda del estado de su fila y columna. (Heredado de DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Obtiene el estilo aplicado a la celda. (Heredado de DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcula el tamaño preferido, en píxeles, de la celda.
GetSize(Int32)	Obtiene el tamaño de la celda. (Heredado de DataGridViewCell)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Int32)	Obtiene el valor de la celda. (Heredado de DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inicializa el control utilizado para editar la celda. (Heredado de DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica si se deja de compartir la fila que contiene la celda cuando se presiona una tecla mientras la celda tiene el foco.
KeyEntersEditMode(KeyEventArgs)	Determina si el modo de edición se debe iniciar basándose en la clave dada. (Heredado de DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica si una fila va a dejar de estar compartida cuando se presiona una tecla mientras el foco está en una celda de la fila. (Heredado de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica si se deja de compartir la fila que contiene la celda cuando se suelta una tecla mientras la celda tiene el foco.
LeaveUnsharesRow(Int32, Boolean)	Indica si una fila va a dejar de estar compartida cuando el foco abandone una celda de la fila. (Heredado de DataGridViewCell)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila va a dejar de estar compartida cuando el usuario haga clic en un botón del mouse mientras el puntero está en una celda de la fila. (Heredado de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila va a dejar de estar compartida cuando el usuario haga doble clic en una celda de la fila. (Heredado de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si se dejará de compartir la fila que contiene la celda cuando se presiona el botón del mouse mientras el puntero está sobre la celda.
MouseEnterUnsharesRow(Int32)	Indica si dejará de compartirse la fila que contiene la celda cuando el puntero del mouse se mueva sobre la celda.
MouseLeaveUnsharesRow(Int32)	Indica si dejará de compartirse la fila que contiene la celda cuando el puntero del mouse salga de la celda.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila va a dejar de estar compartida cuando el puntero del mouse se sitúe sobre una celda de la fila. (Heredado de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si se dejará de compartir la fila que contiene la celda cuando se suelta el botón del mouse mientras el puntero está sobre la celda.
OnClick(DataGridViewCellEventArgs)	Se le llama al hacer clic en la celda. (Heredado de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Se le llama al hacer clic en el contenido de la celda.
OnContentDoubleClick(DataGridViewCellEventArgs)	Se le llama al hacer doble clic en el contenido de la celda.
OnDataGridViewChanged()	Se le llama cuando cambia la propiedad DataGridView de la celda. (Heredado de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Se le llama al hacer doble clic en la celda. (Heredado de DataGridViewCell)
OnEnter(Int32, Boolean)	Se le llama cuando el foco se desplaza a una celda. (Heredado de DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Se le llama cuando se presiona una tecla de carácter mientras el foco está en una celda.
OnKeyPress(KeyPressEventArgs, Int32)	Se le llama cuando se presiona una tecla mientras el foco está en una celda. (Heredado de DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Se le llama cuando se suelta una tecla de carácter mientras el foco está en una celda.
OnLeave(Int32, Boolean)	Se le llama cuando el foco se desplaza de una celda.
OnMouseClick(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario hace clic en un botón del mouse mientras el puntero está en una celda. (Heredado de DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Se le llama cuando el usuario hace doble clic en un botón del mouse mientras el puntero está en una celda. (Heredado de DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Se le llama cuando se mantiene presionado el botón del mouse mientras el puntero está en una celda.
OnMouseEnter(Int32)	Se le llama cuando el puntero del mouse se mueve sobre una celda. (Heredado de DataGridViewCell)
OnMouseLeave(Int32)	Se le llama cuando el puntero del mouse se desplaza de una celda.
OnMouseMove(DataGridViewCellMouseEventArgs)	Se le llama cuando el puntero del mouse se mueve dentro de una celda.
OnMouseUp(DataGridViewCellMouseEventArgs)	Se le llama cuando se suelta el botón del mouse mientras el puntero está en una celda.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Pinta el objeto DataGridViewCheckBoxCell actual.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Dibuja el borde de la clase DataGridViewCell actual. (Heredado de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Dibuja el icono de error del control DataGridViewCell actual. (Heredado de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Convierte un valor con formato para la presentación en un valor de celda real.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Establece la ubicación y tamaño del control de edición que hospeda una celda del control DataGridView. (Heredado de DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Establece la ubicación y tamaño del panel de edición hospedado por la celda y devuelve los límites normales del control de edición dentro del panel de edición. (Heredado de DataGridViewCell)
PrepareEditingCellForEdit(Boolean)	Este método no es significativo para este tipo.
RaiseCellClick(DataGridViewCellEventArgs)	Genera el evento CellClick. (Heredado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Genera el evento CellContentClick. (Heredado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Genera el evento CellContentDoubleClick. (Heredado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Genera el evento CellValueChanged. (Heredado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Genera el evento DataError. (Heredado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Genera el evento MouseWheel. (Heredado de DataGridViewElement)
SetValue(Int32, Object)	Establece el valor de la celda. (Heredado de DataGridViewCell)
ToString()	Devuelve la representación de cadena de la celda.

Consulte también

• DataGridView
• DataGridViewCell
• DataGridViewCheckBoxColumn
• CellTemplate