DataGridViewCheckBoxColumn Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Hospeda una colección de objetos DataGridViewCheckBoxCell.

public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn

[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn

[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn

Herencia

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Atributos

ToolboxBitmapAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar para DataGridViewCheckBoxColumn marcar qué empleados están fuera de la oficina. 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 DataGridViewCheckBoxColumn clase es un tipo especializado de la DataGridViewColumn clase que se usa para hospedar lógicamente celdas que indican el estado binario. Un DataGridViewCheckBoxColumn objeto tiene asociado DataGridViewCheckBoxCell en cada DataGridViewRow que lo interseca. Cada celda proporciona una interfaz de usuario (UI) similar a un CheckBox control.

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

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.CellContentClick, 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 DataGridViewCheckBoxColumn 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

DataGridViewCheckBoxColumn()	Inicializa una nueva instancia de la clase DataGridViewCheckBoxColumn con el estado predeterminado.
DataGridViewCheckBoxColumn(Boolean)	Inicializa una nueva instancia de DataGridViewCheckBoxColumn y la configura para mostrar las casillas con dos o tres estados.

Propiedades

AutoSizeMode	Obtiene o establece el modo mediante el cual la columna ajusta automáticamente su tamaño. (Heredado de DataGridViewColumn)
CellTemplate	Obtiene o establece la plantilla utilizada para crear nuevas celdas.
CellType	Obtiene el tipo en tiempo de ejecución de la plantilla de celda. (Heredado de DataGridViewColumn)
ContextMenuStrip	Obtiene o establece el menú contextual para la columna. (Heredado de DataGridViewColumn)
DataGridView	Obtiene el control DataGridView asociado a este elemento. (Heredado de DataGridViewElement)
DataPropertyName	Obtiene o establece el nombre de la columna de base de datos o la propiedad del origen de datos a la que se enlaza DataGridViewColumn. (Heredado de DataGridViewColumn)
DefaultCellStyle	Obtiene o establece el estilo predeterminado de celda de la columna.
DefaultHeaderCellType	Obtiene o establece el tipo de la celda de encabezado predeterminada en tiempo de ejecución. (Heredado de DataGridViewBand)
Displayed	Obtiene un valor que indica si la banda se muestra actualmente en la pantalla. (Heredado de DataGridViewBand)
DisplayIndex	Obtiene o establece el orden de presentación de la columna respecto de las columnas actualmente mostradas. (Heredado de DataGridViewColumn)
DividerWidth	Obtiene o establece el ancho, en píxeles, del divisor de columna. (Heredado de DataGridViewColumn)
FalseValue	Obtiene o establece el valor subyacente que corresponde a un valor de celda de false, que aparece como una casilla desactivada.
FillWeight	Obtiene o establece un valor que representa el ancho de la columna cuando se encuentra en modo de relleno, respecto del ancho de las demás columnas del control que estén en modo de relleno. (Heredado de DataGridViewColumn)
FlatStyle	Obtiene o establece la apariencia de estilo plano de las celdas de casilla.
Frozen	Obtiene o establece un valor que indica si la columna se va a mover cuando el usuario se desplace horizontalmente por el control DataGridView. (Heredado de DataGridViewColumn)
HasDefaultCellStyle	Obtiene un valor que indica si se ha establecido la propiedad DefaultCellStyle. (Heredado de DataGridViewBand)
HeaderCell	Obtiene o establece el objeto DataGridViewColumnHeaderCell que representa el encabezado de columna. (Heredado de DataGridViewColumn)
HeaderCellCore	Obtiene o establece la celda de encabezado de DataGridViewBand. (Heredado de DataGridViewBand)
HeaderText	Obtiene o establece el texto de título en la celda de encabezado de columna. (Heredado de DataGridViewColumn)
IndeterminateValue	Obtiene o establece el valor subyacente que corresponde a un valor de celda indeterminado o null, que aparece como una casilla deshabilitada.
Index	Obtiene la posición relativa de la banda dentro del control DataGridView. (Heredado de DataGridViewBand)
InheritedAutoSizeMode	Obtiene el modo de ajuste de tamaño en vigor para la columna. (Heredado de DataGridViewColumn)
InheritedStyle	Obtiene el estilo de celda aplicado actualmente a la columna. (Heredado de DataGridViewColumn)
IsDataBound	Obtiene un valor que indica si la columna está enlazada a un origen de datos. (Heredado de DataGridViewColumn)
IsRow	Obtiene un valor que indica si la banda representa una fila. (Heredado de DataGridViewBand)
MinimumWidth	Obtiene o establece el ancho mínimo, en píxeles, de la columna. (Heredado de DataGridViewColumn)
Name	Obtiene o establece el nombre de la columna. (Heredado de DataGridViewColumn)
ReadOnly	Obtiene o establece un valor que indica si el usuario puede editar las celdas de la columna. (Heredado de DataGridViewColumn)
Resizable	Obtiene o establece un valor que indica si se puede cambiar el tamaño de la columna. (Heredado de DataGridViewColumn)
Selected	Obtiene o establece un valor que indica si la banda está en un estado seleccionado de la interfaz de usuario (UI). (Heredado de DataGridViewBand)
Site	Obtiene o establece el sitio de la columna. (Heredado de DataGridViewColumn)
SortMode	Obtiene o establece el modo de ordenación de la columna. (Heredado de DataGridViewColumn)
State	Obtiene el estado de la interfaz de usuario del elemento. (Heredado de DataGridViewElement)
Tag	Obtiene o establece el objeto que contiene datos para asociar a la banda. (Heredado de DataGridViewBand)
ThreeState	Obtiene o establece un valor que indica si las celdas de casilla hospedadas permitirán tener tres estados de verificación en lugar de dos.
ToolTipText	Obtiene o establece el texto que se utiliza como información sobre herramientas. (Heredado de DataGridViewColumn)
TrueValue	Obtiene o establece el valor subyacente que corresponde a un valor de celda de true, que aparece como una casilla activada.
ValueType	Obtiene o establece el tipo de datos de los valores de las celdas de la columna. (Heredado de DataGridViewColumn)
Visible	Obtiene o establece un valor que indica si la columna está visible. (Heredado de DataGridViewColumn)
Width	Obtiene o establece el ancho actual de la columna. (Heredado de DataGridViewColumn)

Métodos

Clone()	Crea una copia exacta de esta banda. (Heredado de DataGridViewColumn)
Dispose()	Libera todos los recursos que usa DataGridViewBand. (Heredado de DataGridViewBand)
Dispose(Boolean)	Libera los recursos no administrados que usa DataGridViewBand y, de forma opcional, libera los recursos administrados. (Heredado de DataGridViewColumn)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Calcula el ancho ideal de la columna basándose en los criterios especificados. (Heredado de DataGridViewColumn)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDataGridViewChanged()	Se llama cuando la banda está asociada a un DataGridView diferente. (Heredado de DataGridViewBand)
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)
ToString()	Obtiene una cadena que describe la columna.

Eventos

Disposed

Se produce cuando se desecha DataGridViewColumn. (Heredado de DataGridViewColumn)

Consulte también

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewCheckBoxCell
• CheckBox
• SortMode
• CellClick
• CellValueChanged
• CurrentCellDirtyStateChanged
• CommitEdit(DataGridViewDataErrorContexts)