Partage via


DataGridViewCheckBoxColumn Classe

Définition

Héberge une collection d'objets DataGridViewCheckBoxCell.

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")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn
Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn
Héritage
Attributs

Exemples

L’exemple de code suivant montre comment utiliser un DataGridViewCheckBoxColumn pour marquer les employés qui ne sont pas au bureau. 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 DataGridViewCheckBoxColumn classe est un type spécialisé de la DataGridViewColumn classe utilisée pour héberger logiquement des cellules qui indiquent l’état binaire. A DataGridViewCheckBoxColumn un associé DataGridViewCheckBoxCell dans chaque DataGridViewRow qui le croise. Chaque cellule fournit une interface utilisateur (IU) similaire à un CheckBox contrôle.

Le mode de tri par défaut pour ce type de colonne est NotSortable.

En règle générale, les valeurs des cellules case activée 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.CellContentClick, 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 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 zone case activée, appelez la DataGridView.CommitEdit méthode et transmettez la Commit valeur.

Notes pour les héritiers

Lorsque vous dérivez de DataGridViewCheckBoxColumn et ajoutez de 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

DataGridViewCheckBoxColumn()

Initialise une nouvelle instance de la classe DataGridViewCheckBoxColumn à son état par défaut.

DataGridViewCheckBoxColumn(Boolean)

Initialise une nouvelle instance du DataGridViewCheckBoxColumn et la configure pour afficher des cases à cocher avec deux ou trois états.

Propriétés

AutoSizeMode

Obtient ou définit le mode qui permet à la colonne de modifier automatiquement sa largeur.

(Hérité de DataGridViewColumn)
CellTemplate

Obtient ou définit le modèle utilisé pour créer des cellules.

CellType

Obtient le type d'exécution du modèle de cellule.

(Hérité de DataGridViewColumn)
ContextMenuStrip

Obtient ou définit le menu contextuel pour la colonne.

(Hérité de DataGridViewColumn)
DataGridView

Obtient le contrôle DataGridView associé à cet élément.

(Hérité de DataGridViewElement)
DataPropertyName

Obtient ou définit le nom de la propriété de source de données ou de la colonne de base de données à laquelle DataGridViewColumn est lié.

(Hérité de DataGridViewColumn)
DefaultCellStyle

Obtient ou définit le style de cellule par défaut de la colonne.

DefaultHeaderCellType

Obtient ou définit le type à l'exécution de la cellule d'en-tête par défaut.

(Hérité de DataGridViewBand)
Displayed

Obtient une valeur indiquant si la bande est actuellement affichée à l'écran.

(Hérité de DataGridViewBand)
DisplayIndex

Obtient ou définit l'ordre d'affichage de la colonne par rapport aux colonnes actuellement affichées.

(Hérité de DataGridViewColumn)
DividerWidth

Obtient ou définit la largeur, en pixels, du séparateur de colonne.

(Hérité de DataGridViewColumn)
FalseValue

Obtient ou définit la valeur sous-jacente correspondant à une valeur de cellule false qui apparaît comme une case à cocher désactivée.

FillWeight

Obtient ou définit une valeur qui représente la largeur de la colonne en mode de remplissage par rapport aux largeurs des autres colonnes en mode de remplissage contenues dans le contrôle.

(Hérité de DataGridViewColumn)
FlatStyle

Obtient ou définit l'apparence à deux dimensions (flat) des cellules de case à cocher.

Frozen

Obtient ou définit une valeur indiquant si une colonne se déplace lorsqu'un utilisateur fait défiler horizontalement le contrôle DataGridView.

(Hérité de DataGridViewColumn)
HasDefaultCellStyle

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

(Hérité de DataGridViewBand)
HeaderCell

Obtient ou définit DataGridViewColumnHeaderCell qui représente l'en-tête de colonne.

(Hérité de DataGridViewColumn)
HeaderCellCore

Obtient ou définit la cellule d'en-tête du DataGridViewBand.

(Hérité de DataGridViewBand)
HeaderText

Obtient ou définit le texte de légende pour la cellule d'en-tête de la colonne.

(Hérité de DataGridViewColumn)
IndeterminateValue

Obtient ou définit la valeur sous-jacente correspondant à une valeur de cellule null ou indéterminée qui apparaît comme une case à cocher désactivée.

Index

Obtient la position relative de la bande dans le contrôle DataGridView.

(Hérité de DataGridViewBand)
InheritedAutoSizeMode

Obtient le mode de dimensionnement défini pour la colonne.

(Hérité de DataGridViewColumn)
InheritedStyle

Obtient le style de cellule actuellement appliqué à la colonne.

(Hérité de DataGridViewColumn)
IsDataBound

Obtient une valeur indiquant si la colonne est liée à une source de données.

(Hérité de DataGridViewColumn)
IsRow

Obtient une valeur indiquant si la bande représente une ligne.

(Hérité de DataGridViewBand)
MinimumWidth

Obtient ou définit la largeur minimale, en pixels, de la colonne.

(Hérité de DataGridViewColumn)
Name

Obtient ou définit le nom de la colonne.

(Hérité de DataGridViewColumn)
ReadOnly

Obtient ou définit une valeur indiquant si l'utilisateur peut modifier les cellules de la colonne.

(Hérité de DataGridViewColumn)
Resizable

Obtient ou définit une valeur indiquant si la colonne peut être redimensionnée.

(Hérité de DataGridViewColumn)
Selected

Obtient ou définit une valeur indiquant si la bande se trouve dans un état sélectionné d'interface utilisateur.

(Hérité de DataGridViewBand)
Site

Obtient ou définit le site de la colonne.

(Hérité de DataGridViewColumn)
SortMode

Obtient ou définit le mode de tri de la colonne.

(Hérité de DataGridViewColumn)
State

Obtient l'état d'interface utilisateur de l'élément.

(Hérité de DataGridViewElement)
Tag

Obtient ou définit l'objet qui contient les données à associer à la bande.

(Hérité de DataGridViewBand)
ThreeState

Obtient ou définit une valeur indiquant si la cellule de case à cocher hébergée autorise l'affichage de trois états d'activation au lieu de deux.

ToolTipText

Obtient ou définit le texte utilisé pour les info-bulles.

(Hérité de DataGridViewColumn)
TrueValue

Obtient ou définit la valeur sous-jacente correspondant à une valeur de cellule true qui apparaît comme une case à cocher activée.

ValueType

Obtient ou définit le type de données des valeurs stockées dans les cellules de la colonne.

(Hérité de DataGridViewColumn)
Visible

Obtient ou définit une valeur qui indique si la colonne est visible.

(Hérité de DataGridViewColumn)
Width

Obtient ou définit la largeur actuelle de la colonne.

(Hérité de DataGridViewColumn)

Méthodes

Clone()

Crée une copie exacte de cette bande.

(Hérité de DataGridViewColumn)
Dispose()

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

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

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

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

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

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Calcule la largeur idéale de la colonne en fonction des critères spécifiés.

(Hérité de DataGridViewColumn)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnDataGridViewChanged()

Appelé lorsque la bande est associée à un DataGridView différent.

(Hérité de DataGridViewBand)
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)
ToString()

Obtient une chaîne qui décrit la colonne.

Événements

Disposed

Se produit lorsque DataGridViewColumn est supprimé.

(Hérité de DataGridViewColumn)

S’applique à

Voir aussi