DataGridViewCheckBoxCell Classe

Définition

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

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell
Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell
Héritage
DataGridViewCheckBoxCell
Implémente

Exemples

L’exemple de code suivant utilise un DataGridViewCheckBoxColumn pour suivre les employés qui se trouvent au bureau. La colonne est composé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é pour afficher des DataGridViewCell informations binaires ou ternaires présentées via une interface utilisateur de zone case activée. 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.

est DataGridViewCheckBoxColumn le type de colonne spécialisé pour contenir les cellules de ce type. Par défaut, le DataGridViewCheckBoxColumn.CellTemplate est initialisé dans un nouveau DataGridViewCheckBoxCell. Pour mettre en forme les cellules d’une colonne à la suite d’un modèle existant 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 de même nom 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 du modèle et toutes les autres cellules de la colonne, et 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, case activée valeurs de cellule box sont destinées au stockage, comme toutes les autres données, ou à l’exécution d’opérations en bloc. Si vous souhaitez répondre immédiatement lorsque les utilisateurs cliquent sur une cellule de zone de case activée, vous pouvez gérer l’événementDataGridView.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 vous cliquez sur la cellule, vous devez gérer l’événement DataGridView.CurrentCellDirtyStateChanged . Dans le gestionnaire, si la cellule active est une cellule de zone de case activée, 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

DataGridViewCheckBoxCell()

Initialise une nouvelle instance de la classe DataGridViewCheckBoxCell dans son état par défaut.

DataGridViewCheckBoxCell(Boolean)

Initialise une nouvelle instance de la classe DataGridViewCheckBoxCell, activant l'état binaire ou ternaire.

Propriétés

AccessibilityObject

Obtient le DataGridViewCell.DataGridViewCellAccessibleObject assigné à DataGridViewCell.

(Hérité de DataGridViewCell)
ColumnIndex

Obtient l'index de colonne pour cette cellule.

(Hérité de DataGridViewCell)
ContentBounds

Obtient le rectangle englobant qui définit 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 contrôle DataGridView associé à cet élément.

(Hérité de DataGridViewElement)
DefaultNewRowValue

Obtient la valeur par défaut d'une cellule contenue dans la ligne des 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 mise en forme de la cellule, que la cellule soit en mode édition ou non et que la valeur ait été validée ou non.

(Hérité de DataGridViewCell)
EditingCellFormattedValue

Obtient ou définit la valeur mise en forme du contrôle hébergé par la cellule lorsque le mode édition est activé.

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 qui décrit 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 false.

FlatStyle

Obtient ou définit l'apparence à deux dimensions (flat) de l'interface utilisateur de type case à cocher.

FormattedValue

Obtient la valeur de la cellule telle qu'elle est mise en forme pour l'affichage.

(Hérité de DataGridViewCell)
FormattedValueType

Obtient le type valeur de l'affichage de la cellule.

Frozen

Obtient une valeur indiquant si la cellule est figée.

(Hérité de DataGridViewCell)
HasStyle

Obtient une valeur indiquant si la propriété Style a été définie.

(Hérité de DataGridViewCell)
IndeterminateValue

Obtient ou définit la valeur sous-jacente correspondant à une valeur de cellule indéterminée ou null.

InheritedState

Obtient l'état actuel de la cellule tel qu'il est hérité de l'état de sa ligne ou 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 actuellement 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 qui peut contenir la cellule.

(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 d'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 les données supplémentaires relatives à 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 Check Box hébergé.

ToolTipText

Obtient ou définit le texte d'info-bulle associé à cette cellule.

(Hérité de DataGridViewCell)
TrueValue

Obtient ou définit la valeur sous-jacente correspondant à une valeur de cellule 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 qui indique si la cellule est contenue dans une ligne ou une colonne masquée.

(Hérité de DataGridViewCell)

Méthodes

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 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 est partagée ou non lorsque l'utilisateur clique sur la cellule.

(Hérité de DataGridViewCell)
Clone()

Crée une copie exacte de cette cellule.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

Indique si le partage de la ligne contenant la cellule est annulé lorsque l'utilisateur clique sur le contenu de la cellule.

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indique si le partage de la ligne contenant la cellule est annulé lorsque l'utilisateur double-clique sur le contenu de la cellule.

CreateAccessibilityInstance()

Crée un objet accessible pour le DataGridViewCheckBoxCell.

DetachEditingControl()

Supprime le contrôle d’édition de la cellule de DataGridView.

(Hérité de DataGridViewCell)
Dispose()

Libère toutes les ressources utilisées par DataGridViewCell.

(Hérité de DataGridViewCell)
Dispose(Boolean)

Libère les ressources non managées utilisées par DataGridViewCell et libère éventuellement les ressources managées.

(Hérité de DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indique si la ligne de la cellule est partagée ou non lorsque l'utilisateur double-clique sur la cellule.

(Hérité de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)

Indique si la ligne parente est partagée ou non lorsque le focus est déplacé vers la cellule.

(Hérité de DataGridViewCell)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Récupère la valeur mise en forme de la cellule à copier dans Clipboard.

(Hérité de DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

Retourne le rectangle englobant qui définit la zone de contenu de la cellule, qui est calculée à l’aide du Graphics et du style de cellule spécifiés.

GetContentBounds(Int32)

Retourne le rectangle englobant qui définit la zone de contenu de la cellule à l'aide d'un Graphics par défaut et le style de cellule actuellement défini 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 ou non et que la valeur ait été validée ou non.

(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 qui englobe l'icône d'erreur de la cellule, si 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.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetInheritedContextMenuStrip(Int32)

Obtient le menu contextuel hérité pour la cellule active.

(Hérité de DataGridViewCell)
GetInheritedState(Int32)

Retourne une valeur qui indique l'état actuel de la cellule tel qu'il est hérité de l'état de sa ligne et 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 par défaut, en pixels, de la cellule.

GetSize(Int32)

Obtient la taille de la cellule.

(Hérité de DataGridViewCell)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
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 le partage de la ligne contenant la cellule est annulé lorsqu'une touche est enfoncée pendant que la cellule a le focus.

KeyEntersEditMode(KeyEventArgs)

Détermine si le mode édition doit être démarré en fonction de la touche donnée.

(Hérité de DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)

Indique si une ligne est partagée ou non lorsqu'une touche est enfoncée et que le focus est placé sur une cellule de la ligne.

(Hérité de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)

Indique si le partage de la ligne contenant la cellule est annulé lorsqu'une touche est relâchée pendant que la cellule a le focus.

LeaveUnsharesRow(Int32, Boolean)

Indique si une ligne est partagée ou non lorsque le focus quitte une cellule de la ligne.

(Hérité de DataGridViewCell)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indique si une ligne est partagée ou non lorsque l'utilisateur clique sur le bouton de la souris alors que le pointeur est placé sur une cellule de la ligne.

(Hérité de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indique si une ligne est partagée ou non lorsque l'utilisateur double-clique sur une cellule de la ligne.

(Hérité de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

Indique si le partage de la ligne contenant la cellule est annulé lorsqu'un utilisateur clique sur le bouton de la souris pendant que le pointeur se trouve sur la cellule.

MouseEnterUnsharesRow(Int32)

Indique si le partage de la ligne contenant la cellule est annulé lorsque le pointeur de la souris passe sur la cellule.

MouseLeaveUnsharesRow(Int32)

Indique si le partage de la ligne contenant la cellule est annulé lorsque le pointeur de la souris ne se trouve plus sur la cellule.

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

Indique si une ligne est partagée ou non lorsque le pointeur de la souris se déplace sur une cellule de la ligne.

(Hérité de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

Indique si le partage de la ligne contenant la cellule est annulé lorsqu'un utilisateur relâche le bouton de la souris pendant que le pointeur se trouve sur la cellule.

OnClick(DataGridViewCellEventArgs)

Appelé à la suite d'un clic sur la cellule.

(Hérité de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)

Appelé lorsque l'utilisateur clique sur le contenu de la cellule.

OnContentDoubleClick(DataGridViewCellEventArgs)

Appelé lorsque l'utilisateur double-clique sur le contenu de la cellule.

OnDataGridViewChanged()

Appelé lorsque la propriété DataGridView de la cellule est modifiée.

(Hérité de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)

Appelé à la suite d'un double-clic sur la cellule.

(Hérité de DataGridViewCell)
OnEnter(Int32, Boolean)

Appelé quand 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 tandis que le focus est sur une cellule.

OnKeyPress(KeyPressEventArgs, Int32)

Appelé lorsqu'une touche est enfoncée tandis que le focus est placé sur une cellule.

(Hérité de DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)

Appelé lorsqu'une touche de caractère est relâchée tandis que le focus est sur une cellule.

OnLeave(Int32, Boolean)

Appelé lorsque le focus se déplace d'une cellule.

OnMouseClick(DataGridViewCellMouseEventArgs)

Appelée quand l’utilisateur clique avec un bouton de la souris pendant que le pointeur se trouve sur une cellule.

(Hérité de DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

Appelé lorsque l'utilisateur double-clique sur le bouton de la souris alors que le pointeur est placé sur une cellule.

(Hérité de DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)

Appelé lorsque le bouton de la souris est maintenu enfoncé tandis que le pointeur est 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 relâché tandis que le pointeur est sur une cellule.

Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

Peint le DataGridViewCheckBoxCell actif.

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

Peint la bordure du DataGridViewCell actuel.

(Hérité de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

Peint l'icône d'erreur du DataGridViewCell actif.

(Hérité de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

Convertit une valeur mise en forme pour l'affichage en une 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é par une cellule dans le contrôle DataGridView.

(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.

S’applique à

Voir aussi