DataGridViewCheckBoxColumn Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Hospeda una colección de DataGridViewCheckBoxCell objetos.
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.bmp")>]
type DataGridViewCheckBoxColumn = class
inherit DataGridViewColumnPublic Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn- Herencia
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar un DataGridViewCheckBoxColumn para 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 utilizada 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 celda de casilla de verificación están destinados al almacenamiento, como cualquier otro dato, o para realizar operaciones en lote. Si desea responder inmediatamente cuando los usuarios hacen clic en una celda de casilla de verificación, puede manejar el evento DataGridView.CellContentClick, pero este evento ocurre antes de que se actualice 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 en función del valor actual. Otro enfoque consiste en confirmar el cambio inmediatamente y controlar el DataGridView.CellValueChanged evento para responder a él. Para confirmar el cambio cuando se hace clic en la celda, debe manejar 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
| Nombre | Description |
|---|---|
| DataGridViewCheckBoxColumn() |
Inicializa una nueva instancia de la DataGridViewCheckBoxColumn clase en el estado predeterminado. |
| DataGridViewCheckBoxColumn(Boolean) |
Inicializa una nueva instancia de DataGridViewCheckBoxColumn y la configura para mostrar casillas con dos o tres estados. |
Propiedades
| Nombre | Description |
|---|---|
| AutoSizeMode |
Obtiene o establece el modo por el que la columna ajusta automáticamente su ancho. (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 de la columna. (Heredado de DataGridViewColumn) |
| DataGridView |
Obtiene el DataGridView control asociado a este elemento. (Heredado de DataGridViewElement) |
| DataPropertyName |
Obtiene o establece el nombre de la propiedad de origen de datos o la columna de base de datos a la DataGridViewColumn que está enlazado. (Heredado de DataGridViewColumn) |
| DefaultCellStyle |
Obtiene o establece el estilo de celda predeterminado de la columna. |
| DefaultHeaderCellType |
Obtiene o establece el tipo en tiempo de ejecución de la celda de encabezado predeterminada. (Heredado de DataGridViewBand) |
| Displayed |
Obtiene un valor que indica si la banda se muestra actualmente en pantalla. (Heredado de DataGridViewBand) |
| DisplayIndex |
Obtiene o establece el orden de presentación de la columna en relación con las columnas mostradas actualmente. (Heredado de DataGridViewColumn) |
| DividerWidth |
Obtiene o establece el ancho, en píxeles, del divisor de columnas. (Heredado de DataGridViewColumn) |
| FalseValue |
Obtiene o establece el valor subyacente correspondiente a un valor de celda de |
| FillWeight |
Obtiene o establece un valor que representa el ancho de la columna cuando está en modo de relleno en relación con los anchos de otras columnas en modo de relleno del control. (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 una columna se moverá cuando un usuario desplaza el DataGridView control horizontalmente. (Heredado de DataGridViewColumn) |
| HasDefaultCellStyle |
Obtiene un valor que indica si se ha establecido la DefaultCellStyle propiedad . (Heredado de DataGridViewBand) |
| HeaderCell |
Obtiene o establece el DataGridViewColumnHeaderCell objeto 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 del título en la celda de encabezado de la columna. (Heredado de DataGridViewColumn) |
| IndeterminateValue |
Obtiene o establece el valor subyacente correspondiente a un valor de celda o |
| Index |
Obtiene la posición relativa de la banda dentro del DataGridView control. (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 la columna se puede cambiar de tamaño. (Heredado de DataGridViewColumn) |
| Selected |
Obtiene o establece un valor que indica si la banda está en estado de interfaz de usuario (UI) seleccionada. (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 (UI) del elemento. (Heredado de DataGridViewElement) |
| Tag |
Obtiene o establece el objeto que contiene los datos que se van a asociar a la banda. (Heredado de DataGridViewBand) |
| ThreeState |
Obtiene o establece un valor que indica si las celdas de casilla hospedadas permitirán tres estados de comprobación en lugar de dos. |
| ToolTipText |
Obtiene o establece el texto usado para la información sobre herramientas. (Heredado de DataGridViewColumn) |
| TrueValue |
Obtiene o establece el valor subyacente correspondiente a un valor de celda de |
| 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
| Nombre | Description |
|---|---|
| Clone() |
Crea una copia exacta de esta banda. (Heredado de DataGridViewColumn) |
| Dispose() |
Libera todos los recursos usados por .DataGridViewBand (Heredado de DataGridViewBand) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por DataGridViewBand y, opcionalmente, libera los recursos administrados. (Heredado de DataGridViewColumn) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) |
Calcula el ancho ideal de la columna en función de los criterios especificados. (Heredado de DataGridViewColumn) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnDataGridViewChanged() |
Se llama cuando la banda está asociada a otro DataGridView. (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
| Nombre | Description |
|---|---|
| Disposed |
Se produce cuando DataGridViewColumn se elimina . (Heredado de DataGridViewColumn) |