DataGridViewCheckBoxColumn Clase

Definición

Hospeda una colección de objetos DataGridViewCheckBoxCell.Hosts a collection of DataGridViewCheckBoxCell objects.

public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")]
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn
Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn
Herencia
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo DataGridViewCheckBoxColumn utilizar un para marcar qué empleados están fuera de la oficina.The following code example demonstrates how to use a DataGridViewCheckBoxColumn to mark which employees are out of the office. Este ejemplo forma parte de un ejemplo más grande disponible en DataGridViewComboBoxColumn el tema de información general de la clase.This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

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 las celdas que indican el estado binario.The DataGridViewCheckBoxColumn class is a specialized type of the DataGridViewColumn class used to logically host cells that indicate binary state. Un DataGridViewCheckBoxColumn tiene un asociado DataGridViewCheckBoxCell en cada DataGridViewRow que forma una intersección con él.A DataGridViewCheckBoxColumn has an associated DataGridViewCheckBoxCell in every DataGridViewRow that intersects it. Cada celda proporciona una interfaz de usuario (IU) similar a un CheckBox control.Each cell supplies a user interface (UI) that is similar to a CheckBox control.

El modo de ordenación predeterminado para este tipo NotSortablede columna es.The default sort mode for this column type is NotSortable.

Normalmente, los valores de las celdas de las casillas están pensados para el almacenamiento, como cualquier otro dato, o para realizar operaciones masivas.Typically, check box cell values are intended either for storage, like any other data, or for performing bulk operations. Si desea responder inmediatamente cuando los usuarios hacen clic en una celda de casilla, puede controlar el DataGridView.CellContentClick evento, pero este evento se produce antes de que se actualice el valor de la celda.If you want to respond immediately when users click a check box cell, you can handle the DataGridView.CellContentClick event, but this event occurs before the cell value is updated. 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.If you need the new value at the time of the click, one option is to calculate what the expected value will be based on the current value. Otro enfoque consiste en confirmar el cambio inmediatamente y controlar el DataGridView.CellValueChanged evento para responder a él.Another approach is to commit the change immediately, and handle the DataGridView.CellValueChanged event to respond to it. Para confirmar el cambio cuando se hace clic en la celda, debe controlar el DataGridView.CurrentCellDirtyStateChanged evento.To commit the change when the cell is clicked, you must handle the DataGridView.CurrentCellDirtyStateChanged event. En el controlador, si la celda actual es una celda de casilla, llame al DataGridView.CommitEdit método y pase el Commit valor.In the handler, if the current cell is a check box cell, call the DataGridView.CommitEdit method and pass in the Commit value.

Notas a los desarrolladores de herederos

Al derivar de DataGridViewCheckBoxColumn y agregar 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.When you derive from DataGridViewCheckBoxColumn and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. 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.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

Constructores

DataGridViewCheckBoxColumn()

Inicializa una nueva instancia de la clase DataGridViewCheckBoxColumn con el estado predeterminado.Initializes a new instance of the DataGridViewCheckBoxColumn class to the default state.

DataGridViewCheckBoxColumn(Boolean)

Inicializa una nueva instancia de DataGridViewCheckBoxColumn y la configura para mostrar las casillas con dos o tres estados.Initializes a new instance of the DataGridViewCheckBoxColumn and configures it to display check boxes with two or three states.

Propiedades

AutoSizeMode

Obtiene o establece el modo mediante el cual la columna ajusta automáticamente su tamaño.Gets or sets the mode by which the column automatically adjusts its width.

(Heredado de DataGridViewColumn)
CellTemplate

Obtiene o establece la plantilla utilizada para crear nuevas celdas.Gets or sets the template used to create new cells.

CellType

Obtiene el tipo en tiempo de ejecución de la plantilla de celda.Gets the run-time type of the cell template.

(Heredado de DataGridViewColumn)
ContextMenuStrip

Obtiene o establece el menú contextual para la columna.Gets or sets the shortcut menu for the column.

(Heredado de DataGridViewColumn)
DataGridView

Obtiene el control DataGridView asociado a este elemento.Gets the DataGridView control associated with this element.

(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.Gets or sets the name of the data source property or database column to which the DataGridViewColumn is bound.

(Heredado de DataGridViewColumn)
DefaultCellStyle

Obtiene o establece el estilo predeterminado de celda de la columna.Gets or sets the column's default cell style.

DefaultHeaderCellType

Obtiene o establece el tipo de la celda de encabezado predeterminada en tiempo de ejecución.Gets or sets the run-time type of the default header cell.

(Heredado de DataGridViewBand)
Displayed

Obtiene un valor que indica si la banda se muestra actualmente en la pantalla.Gets a value indicating whether the band is currently displayed onscreen.

(Heredado de DataGridViewBand)
DisplayIndex

Obtiene o establece el orden de presentación de la columna respecto de las columnas actualmente mostradas.Gets or sets the display order of the column relative to the currently displayed columns.

(Heredado de DataGridViewColumn)
DividerWidth

Obtiene o establece el ancho, en píxeles, del divisor de columna.Gets or sets the width, in pixels, of the column divider.

(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.Gets or sets the underlying value corresponding to a cell value of false, which appears as an unchecked box.

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.Gets or sets a value that represents the width of the column when it is in fill mode relative to the widths of other fill-mode columns in the control.

(Heredado de DataGridViewColumn)
FlatStyle

Obtiene o establece la apariencia de estilo plano de las celdas de casilla.Gets or sets the flat style appearance of the check box cells.

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.Gets or sets a value indicating whether a column will move when a user scrolls the DataGridView control horizontally.

(Heredado de DataGridViewColumn)
HasDefaultCellStyle

Obtiene un valor que indica si se ha establecido la propiedad DefaultCellStyle.Gets a value indicating whether the DefaultCellStyle property has been set.

(Heredado de DataGridViewBand)
HeaderCell

Obtiene o establece el objeto DataGridViewColumnHeaderCell que representa el encabezado de columna.Gets or sets the DataGridViewColumnHeaderCell that represents the column header.

(Heredado de DataGridViewColumn)
HeaderCellCore

Obtiene o establece la celda de encabezado de DataGridViewBand.Gets or sets the header cell of the DataGridViewBand.

(Heredado de DataGridViewBand)
HeaderText

Obtiene o establece el texto de título en la celda de encabezado de columna.Gets or sets the caption text on the column's header cell.

(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.Gets or sets the underlying value corresponding to an indeterminate or null cell value, which appears as a disabled checkbox.

Index

Obtiene la posición relativa de la banda dentro del control DataGridView.Gets the relative position of the band within the DataGridView control.

(Heredado de DataGridViewBand)
InheritedAutoSizeMode

Obtiene el modo de ajuste de tamaño en vigor para la columna.Gets the sizing mode in effect for the column.

(Heredado de DataGridViewColumn)
InheritedStyle

Obtiene el estilo de celda aplicado actualmente a la columna.Gets the cell style currently applied to the column.

(Heredado de DataGridViewColumn)
IsDataBound

Obtiene un valor que indica si la columna está enlazada a un origen de datos.Gets a value indicating whether the column is bound to a data source.

(Heredado de DataGridViewColumn)
IsRow

Obtiene un valor que indica si la banda representa una fila.Gets a value indicating whether the band represents a row.

(Heredado de DataGridViewBand)
MinimumWidth

Obtiene o establece el ancho mínimo, en píxeles, de la columna.Gets or sets the minimum width, in pixels, of the column.

(Heredado de DataGridViewColumn)
Name

Obtiene o establece el nombre de la columna.Gets or sets the name of the column.

(Heredado de DataGridViewColumn)
ReadOnly

Obtiene o establece un valor que indica si el usuario puede editar las celdas de la columna.Gets or sets a value indicating whether the user can edit the column's cells.

(Heredado de DataGridViewColumn)
Resizable

Obtiene o establece un valor que indica si se puede cambiar el tamaño de la columna.Gets or sets a value indicating whether the column is resizable.

(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).Gets or sets a value indicating whether the band is in a selected user interface (UI) state.

(Heredado de DataGridViewBand)
Site

Obtiene o establece el sitio de la columna.Gets or sets the site of the column.

(Heredado de DataGridViewColumn)
SortMode

Obtiene o establece el modo de ordenación de la columna.Gets or sets the sort mode for the column.

(Heredado de DataGridViewColumn)
State

Obtiene el estado de la interfaz de usuario del elemento.Gets the user interface (UI) state of the element.

(Heredado de DataGridViewElement)
Tag

Obtiene o establece el objeto que contiene datos para asociar a la banda.Gets or sets the object that contains data to associate with the band.

(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.Gets or sets a value indicating whether the hosted check box cells will allow three check states rather than two.

ToolTipText

Obtiene o establece el texto que se utiliza como información sobre herramientas.Gets or sets the text used for ToolTips.

(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.Gets or sets the underlying value corresponding to a cell value of true, which appears as a checked box.

ValueType

Obtiene o establece el tipo de datos de los valores de las celdas de la columna.Gets or sets the data type of the values in the column's cells.

(Heredado de DataGridViewColumn)
Visible

Obtiene o establece un valor que indica si la columna es visible.Gets or sets a value indicating whether the column is visible.

(Heredado de DataGridViewColumn)
Width

Obtiene o establece el ancho actual de la columna.Gets or sets the current width of the column.

(Heredado de DataGridViewColumn)

Métodos

Clone()

Crea una copia exacta de esta banda.Creates an exact copy of this band.

(Heredado de DataGridViewColumn)
Dispose()

Libera todos los recursos que usa DataGridViewBand.Releases all resources used by the DataGridViewBand.

(Heredado de DataGridViewBand)
Dispose(Boolean)

Libera los recursos no administrados que usa DataGridViewBand y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Heredado de DataGridViewColumn)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Calcula el ancho ideal de la columna basándose en los criterios especificados.Calculates the ideal width of the column based on the specified criteria.

(Heredado de DataGridViewColumn)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnDataGridViewChanged()

Se llama cuando la banda está asociada a un DataGridView diferente.Called when the band is associated with a different DataGridView.

(Heredado de DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)

Genera el evento CellClick.Raises the CellClick event.

(Heredado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Genera el evento CellContentClick.Raises the CellContentClick event.

(Heredado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Genera el evento CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Heredado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Genera el evento CellValueChanged.Raises the CellValueChanged event.

(Heredado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Genera el evento DataError.Raises the DataError event.

(Heredado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Genera el evento MouseWheel.Raises the MouseWheel event.

(Heredado de DataGridViewElement)
ToString()

Obtiene una cadena que describe la columna.Gets a string that describes the column.

Eventos

Disposed

Se produce cuando se desecha DataGridViewColumn.Occurs when the DataGridViewColumn is disposed.

(Heredado de DataGridViewColumn)

Se aplica a

Consulte también: