Compartir a través de


DataGridViewCheckBoxColumn Clase

Definición

Hospeda una colección de objetos DataGridViewCheckBoxCell.

public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")]
public 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.bmp")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn
Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn
Herencia
Atributos

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)

Se aplica a

Consulte también