DataGridViewCheckBoxCell Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewCheckBoxCell.cs

Affiche une case à cocher de l’interface utilisateur à utiliser dans un DataGridView contrôle.

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

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

Héritage

Object

DataGridViewElement

DataGridViewCell

DataGridViewCheckBoxCell

Attributs

DynamicallyAccessedMembersAttribute

Implémente

IDataGridViewEditingCell

Exemples

L’exemple de code suivant utilise un DataGridViewCheckBoxColumn pour suivre les employés qui se trouvent dans le bureau. La colonne est constituée d’objets DataGridViewCheckBoxCell . Cet exemple fait partie d’un exemple plus large disponible dans la rubrique vue d’ensemble de la DataGridViewComboBoxColumn classe.

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

Remarques

La DataGridViewCheckBoxCell classe est un type spécialisé utilisé DataGridViewCell pour afficher des informations binaires ou ternaires présentées par le biais d’une interface utilisateur de case à cocher. En mode binaire par défaut, les cellules peuvent contenir des valeurs de true ou false. En mode ternaire, les cellules prennent l’une des CheckState valeurs. La ThreeState propriété détermine si le mode binaire ou ternaire est en vigueur.

Il DataGridViewCheckBoxColumn s’agit du type de colonne spécialisé pour contenir des cellules de ce type. Par défaut, l’initialisation DataGridViewCheckBoxColumn.CellTemplate est effectuée sur un nouveau DataGridViewCheckBoxCell. Pour modèler les cellules d’une colonne après une propriété existante DataGridViewCheckBoxCell, définissez la propriété de CellTemplate la colonne sur la cellule à utiliser comme modèle.

Les propriétés liées aux cellules de la colonne sont des wrappers pour les propriétés nommées de la même façon de la cellule de modèle. La modification des valeurs de propriété de la cellule de modèle affecte uniquement les cellules en fonction du modèle qui sont ajoutées après la modification. Toutefois, la modification des valeurs de propriété liées aux cellules de la colonne met à jour la cellule de modèle et toutes les autres cellules de la colonne, puis actualise l’affichage de la colonne si nécessaire.

Lorsque la cellule active est un DataGridViewCheckBoxCell, la DataGridView.IsCurrentCellInEditMode propriété est toujours true.

En règle générale, les valeurs de cellule de case à cocher sont destinées au stockage, comme toutes les autres données, ou pour effectuer des opérations en bloc. Si vous souhaitez répondre immédiatement lorsque les utilisateurs cliquent sur une cellule de case à cocher, vous pouvez gérer l’événement DataGridView.CellClick , mais cet événement se produit avant la mise à jour de la valeur de la cellule. Si vous avez besoin de la nouvelle valeur au moment du clic, une option consiste à calculer la valeur attendue en fonction de la valeur actuelle. Une autre approche consiste à valider immédiatement la modification et à gérer l’événement DataGridView.CellValueChanged pour y répondre. Pour valider la modification lorsque la cellule est cliquée, vous devez gérer l’événement DataGridView.CurrentCellDirtyStateChanged . Dans le gestionnaire, si la cellule active est une cellule à cocher, appelez la DataGridView.CommitEdit méthode et transmettez la Commit valeur.

Notes pour les héritiers

Lorsque vous dérivez et ajoutez de DataGridViewCheckBoxCell nouvelles propriétés à la classe dérivée, veillez à remplacer la Clone() méthode pour copier les nouvelles propriétés pendant les opérations de clonage. Vous devez également appeler la méthode de la classe de Clone() base afin que les propriétés de la classe de base soient copiées dans la nouvelle cellule.

Constructeurs

Nom	Description
DataGridViewCheckBoxCell()	Initialise une nouvelle instance de la DataGridViewCheckBoxCell classe à son état par défaut.
DataGridViewCheckBoxCell(Boolean)	Initialise une nouvelle instance de la DataGridViewCheckBoxCell classe, en activant l’état binaire ou ternaire.

Propriétés

Nom	Description
AccessibilityObject	Obtient l’objet affecté à l’objet DataGridViewCell.DataGridViewCellAccessibleObjectDataGridViewCell. (Hérité de DataGridViewCell)
ColumnIndex	Obtient l’index de colonne pour cette cellule. (Hérité de DataGridViewCell)
ContentBounds	Obtient le rectangle englobant qui entoure la zone de contenu de la cellule. (Hérité de DataGridViewCell)
ContextMenuStrip	Obtient ou définit le menu contextuel associé à la cellule. (Hérité de DataGridViewCell)
DataGridView	Obtient le DataGridView contrôle associé à cet élément. (Hérité de DataGridViewElement)
DefaultNewRowValue	Obtient la valeur par défaut d’une cellule de la ligne pour les nouveaux enregistrements. (Hérité de DataGridViewCell)
Displayed	Obtient une valeur qui indique si la cellule est actuellement affichée à l’écran. (Hérité de DataGridViewCell)
EditedFormattedValue	Obtient la valeur actuelle et mise en forme de la cellule, que la cellule soit en mode édition et que la valeur n’ait pas été validée. (Hérité de DataGridViewCell)
EditingCellFormattedValue	Obtient ou définit la valeur mise en forme du contrôle hébergé par la cellule lorsqu’il est en mode édition.
EditingCellValueChanged	Obtient ou définit un indicateur indiquant que la valeur a été modifiée pour cette cellule.
EditType	Obtient le type du contrôle d’édition hébergé de la cellule.
ErrorIconBounds	Obtient les limites de l’icône d’erreur pour la cellule. (Hérité de DataGridViewCell)
ErrorText	Obtient ou définit le texte décrivant une condition d’erreur associée à la cellule. (Hérité de DataGridViewCell)
FalseValue	Obtient ou définit la valeur sous-jacente correspondant à une valeur de cellule de false.
FlatStyle	Obtient ou définit l’apparence de style plat de l’interface utilisateur de la case à cocher.
FormattedValue	Obtient la valeur de la cellule comme mise en forme pour l’affichage. (Hérité de DataGridViewCell)
FormattedValueType	Obtient le type de la valeur d’affichage de cellule.
Frozen	Obtient une valeur indiquant si la cellule est figée. (Hérité de DataGridViewCell)
HasStyle	Obtient une valeur indiquant si la Style propriété a été définie. (Hérité de DataGridViewCell)
IndeterminateValue	Obtient ou définit la valeur sous-jacente correspondant à une valeur indéterminée ou null de cellule.
InheritedState	Obtient l’état actuel de la cellule comme hérité de l’état de sa ligne et de sa colonne. (Hérité de DataGridViewCell)
InheritedStyle	Obtient le style actuellement appliqué à la cellule. (Hérité de DataGridViewCell)
IsInEditMode	Obtient une valeur indiquant si cette cellule est en cours de modification. (Hérité de DataGridViewCell)
OwningColumn	Obtient la colonne qui contient cette cellule. (Hérité de DataGridViewCell)
OwningRow	Obtient la ligne qui contient cette cellule. (Hérité de DataGridViewCell)
PreferredSize	Obtient la taille, en pixels, d’une zone rectangulaire dans laquelle la cellule peut s’adapter. (Hérité de DataGridViewCell)
ReadOnly	Obtient ou définit une valeur indiquant si les données de la cellule peuvent être modifiées. (Hérité de DataGridViewCell)
Resizable	Obtient une valeur indiquant si la cellule peut être redimensionnée. (Hérité de DataGridViewCell)
RowIndex	Obtient l’index de la ligne parente de la cellule. (Hérité de DataGridViewCell)
Selected	Obtient ou définit une valeur indiquant si la cellule a été sélectionnée. (Hérité de DataGridViewCell)
Size	Obtient la taille de la cellule. (Hérité de DataGridViewCell)
State	Obtient l’état de l’interface utilisateur de l’élément. (Hérité de DataGridViewElement)
Style	Obtient ou définit le style de la cellule. (Hérité de DataGridViewCell)
Tag	Obtient ou définit l’objet qui contient des données supplémentaires sur la cellule. (Hérité de DataGridViewCell)
ThreeState	Obtient ou définit une valeur indiquant si le mode ternaire a été activé pour le contrôle de case à cocher hébergé.
ToolTipText	Obtient ou définit le texte info-bulle associé à cette cellule. (Hérité de DataGridViewCell)
TrueValue	Obtient ou définit la valeur sous-jacente correspondant à une valeur de cellule de true.
Value	Obtient ou définit la valeur associée à cette cellule. (Hérité de DataGridViewCell)
ValueType	Obtient le type de données des valeurs de la cellule.
Visible	Obtient une valeur indiquant si la cellule se trouve dans une ligne ou une colonne masquée. (Hérité de DataGridViewCell)

Méthodes

Nom	Description
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifie le style de bordure de cellule d’entrée en fonction des critères spécifiés. (Hérité de DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Retourne un Rectangle qui représente les largeurs de toutes les marges de cellule. (Hérité de DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne de la cellule n’est pas partagé lorsque la cellule est cliquée. (Hérité de DataGridViewCell)
Clone()	Crée une copie exacte de cette cellule.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne contenant la cellule ne sera pas partagé lorsque le contenu de la cellule est cliqué.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne contenant la cellule ne sera pas partagé lorsque le contenu de la cellule est double-cliqué.
CreateAccessibilityInstance()	Crée un objet accessible pour le DataGridViewCheckBoxCell.
DetachEditingControl()	Supprime le contrôle d’édition de la cellule du DataGridView. (Hérité de DataGridViewCell)
Dispose()	Libère toutes les ressources utilisées par le DataGridViewCell. (Hérité de DataGridViewCell)
Dispose(Boolean)	Libère les ressources non managées utilisées par les DataGridViewCell ressources gérées et libère éventuellement les ressources managées. (Hérité de DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne de la cellule n’est pas partagé lorsque la cellule est double-cliquée. (Hérité de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indique si la ligne parente est départagée lorsque le focus se déplace vers la cellule. (Hérité de DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Récupère la valeur mise en forme de la cellule à copier dans le Clipboard. (Hérité de DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Retourne le rectangle englobant qui entoure la zone de contenu de la cellule, qui est calculée à l’aide du style de cellule et spécifié Graphics .
GetContentBounds(Int32)	Retourne le rectangle englobant qui entoure la zone de contenu de la cellule à l’aide d’un style par défaut Graphics et de cellule actuellement en vigueur pour la cellule. (Hérité de DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Retourne la valeur actuelle mise en forme de la cellule, que la cellule soit en mode édition et que la valeur n’ait pas été validée. (Hérité de DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)	Obtient la valeur mise en forme de la cellule pendant qu’elle est en mode édition.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Retourne le rectangle englobant qui entoure l’icône d’erreur de la cellule, si celle-ci est affichée.
GetErrorText(Int32)	Retourne une chaîne qui représente l’erreur pour la cellule. (Hérité de DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Obtient la valeur mise en forme des données de la cellule.
GetInheritedContextMenuStrip(Int32)	Obtient le menu contextuel hérité de la cellule active. (Hérité de DataGridViewCell)
GetInheritedState(Int32)	Retourne une valeur indiquant l’état actuel de la cellule comme hérité de l’état de sa ligne et de sa colonne. (Hérité de DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Obtient le style appliqué à la cellule. (Hérité de DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcule la taille préférée, en pixels, de la cellule.
GetSize(Int32)	Obtient la taille de la cellule. (Hérité de DataGridViewCell)
GetValue(Int32)	Obtient la valeur de la cellule. (Hérité de DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Initialise le contrôle utilisé pour modifier la cellule. (Hérité de DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indique si la ligne contenant la cellule n’est pas partagé lorsqu’une touche est enfoncée pendant que la cellule a le focus.
KeyEntersEditMode(KeyEventArgs)	Détermine si le mode d’édition doit être démarré en fonction de la clé donnée. (Hérité de DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indique si une ligne ne sera pas partagé si une touche est enfoncée pendant qu’une cellule de la ligne a le focus. (Hérité de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indique si la ligne contenant la cellule n’est pas partagé lorsqu’une clé est libérée pendant que la cellule a le focus.
LeaveUnsharesRow(Int32, Boolean)	Indique si une ligne ne sera pas partagé lorsque le focus laisse une cellule dans la ligne. (Hérité de DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si une ligne ne sera pas partagé si l’utilisateur clique sur un bouton de souris pendant que le pointeur se trouve sur une cellule de la ligne. (Hérité de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si une ligne ne sera pas partagé si l’utilisateur double-clique sur une cellule de la ligne. (Hérité de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si la ligne contenant la cellule ne sera pas partagé lorsque le bouton de la souris est enfoncé pendant que le pointeur se trouve sur la cellule.
MouseEnterUnsharesRow(Int32)	Indique si la ligne contenant la cellule ne sera pas partagé lorsque le pointeur de la souris se déplace sur la cellule.
MouseLeaveUnsharesRow(Int32)	Indique si la ligne contenant la cellule ne sera pas partagé lorsque le pointeur de la souris quitte la cellule.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si une ligne est départagée lorsque le pointeur de la souris se déplace sur une cellule de la ligne. (Hérité de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si la ligne contenant la cellule ne sera pas partagé lorsque le bouton de la souris est libéré pendant que le pointeur se trouve sur la cellule.
OnClick(DataGridViewCellEventArgs)	Appelé lorsque la cellule est cliquée. (Hérité de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Appelé lorsque le contenu de la cellule est cliqué.
OnContentDoubleClick(DataGridViewCellEventArgs)	Appelé lorsque le contenu de la cellule est double-cliqué.
OnDataGridViewChanged()	Appelé lorsque la DataGridView propriété de la cellule change. (Hérité de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Appelé lorsque la cellule est double-cliquée. (Hérité de DataGridViewCell)
OnEnter(Int32, Boolean)	Appelé lorsque le focus se déplace vers une cellule. (Hérité de DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Appelé lorsqu’une touche de caractère est enfoncée pendant que le focus se trouve sur une cellule.
OnKeyPress(KeyPressEventArgs, Int32)	Appelé lorsqu’une touche est enfoncée pendant que le focus est sur une cellule. (Hérité de DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Appelé lorsqu’une touche de caractère est libérée pendant que le focus est sur une cellule.
OnLeave(Int32, Boolean)	Appelé lorsque le focus se déplace d’une cellule.
OnMouseClick(DataGridViewCellMouseEventArgs)	Appelé lorsque l’utilisateur clique sur un bouton de souris pendant que le pointeur se trouve sur une cellule. (Hérité de DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Appelé lorsque l’utilisateur double-clique sur un bouton de souris pendant que le pointeur se trouve sur une cellule. (Hérité de DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Appelé lorsque le bouton de la souris est enfoncé pendant que le pointeur se trouve sur une cellule.
OnMouseEnter(Int32)	Appelé lorsque le pointeur de la souris se déplace sur une cellule. (Hérité de DataGridViewCell)
OnMouseLeave(Int32)	Appelé lorsque le pointeur de la souris se déplace d’une cellule.
OnMouseMove(DataGridViewCellMouseEventArgs)	Appelé lorsque le pointeur de la souris se déplace dans une cellule.
OnMouseUp(DataGridViewCellMouseEventArgs)	Appelé lorsque le bouton de la souris est libéré pendant que le pointeur se trouve sur une cellule.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Peint le courant DataGridViewCheckBoxCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Peint la bordure du courant DataGridViewCell. (Hérité de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Peint l’icône d’erreur du fichier actif DataGridViewCell. (Hérité de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Convertit une valeur mise en forme pour l’affichage en valeur de cellule réelle.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Définit l’emplacement et la taille du contrôle d’édition hébergés par une cellule du DataGridView contrôle. (Hérité de DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Définit l’emplacement et la taille du panneau d’édition hébergé par la cellule et retourne les limites normales du contrôle d’édition dans le panneau d’édition. (Hérité de DataGridViewCell)
PrepareEditingCellForEdit(Boolean)	Cette méthode n’est pas significative pour ce type.
RaiseCellClick(DataGridViewCellEventArgs)	Déclenche l’événement CellClick. (Hérité de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Déclenche l’événement CellContentClick. (Hérité de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Déclenche l’événement CellContentDoubleClick. (Hérité de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Déclenche l’événement CellValueChanged. (Hérité de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Déclenche l’événement DataError. (Hérité de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Déclenche l’événement MouseWheel. (Hérité de DataGridViewElement)
SetValue(Int32, Object)	Définit la valeur de la cellule. (Hérité de DataGridViewCell)
ToString()	Retourne la représentation sous forme de chaîne de la cellule.

Voir aussi

• DataGridView
• DataGridViewCell
• DataGridViewCheckBoxColumn
• CellTemplate