Exporter (0) Imprimer
Développer tout

DataGridViewCheckBoxCell, classe

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

Espace de noms: System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public class DataGridViewCheckBoxCell : DataGridViewCell, IDataGridViewEditingCell
public class DataGridViewCheckBoxCell extends DataGridViewCell implements IDataGridViewEditingCell
public class DataGridViewCheckBoxCell extends DataGridViewCell implements IDataGridViewEditingCell
Non applicable.

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

DataGridViewCheckBoxColumn correspond au type de colonne spécialisé destiné à contenir des cellules de ce type. Pour modéliser les cellules d'une colonne à partir d'un DataGridViewCheckBoxCell existant, affectez cette cellule à la propriété CellTemplate de la colonne. Par défaut, CellTemplate est initialisé à un nouveau DataGridViewCheckBoxCell.

Les propriétés de cellule de la colonne sont des wrappers pour les propriétés de même nom du modèle de cellule. La modification des valeurs de propriété du modèle de cellule affectera uniquement les cellules basées sur le modèle qui sont ajoutées après la modification. Toutefois, la modification des valeurs de propriété de cellule de la colonne mettra à jour le modèle de cellule et toutes les autres cellules de la colonne et actualisera l'affichage de la colonne si nécessaire.

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

En général, les valeurs de cellules de case à cocher sont destinées au stockage, comme toute autre donnée, ou à l'exécution d'opérations en bloc. Si vous souhaitez répondre immédiatement au clic des utilisateurs 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 lors du clic, une option consiste à calculer la valeur attendue d'après 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 l'utilisateur clique sur la cellule, vous devez gérer l'événement DataGridView.CurrentCellDirtyStateChanged. Dans le gestionnaire, si la cellule active est une cellule de case à cocher, appelez la méthode DataGridView.CommitEdit et passez la valeur Commit.

Remarques à l'attention des héritiers : Lorsque vous effectuez une dérivation à partir de DataGridViewCheckBoxCell et ajoutez de nouvelles propriétés à la classe dérivée, veillez à substituer la méthode Clone pour copier les nouvelles propriétés au cours des opérations de clonage. Vous devez également appeler la méthode Clone de la classe de base afin que les propriétés de cette classe de base soient copiées dans la nouvelle cellule.

L'exemple de code suivant utilise DataGridViewCheckBoxColumn pour vérifier quels employés sont au bureau. La colonne est composée des objets DataGridViewCheckBoxCell. Cet exemple fait partie d'un exemple plus développé disponible dans la rubrique sur la vue d'ensemble de la classe DataGridViewComboBoxColumn.

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);
}

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft