DataGridViewCell Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une cellule dans un contrôle DataGridView.

public ref class DataGridViewCell abstract : System::Windows::Forms::DataGridViewElement, ICloneable, IDisposable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable

Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable

Héritage: Object

DataGridViewElement
DataGridViewCell

Dérivé: System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

Plus…

Attributs: TypeConverterAttribute

Implémente: ICloneable IDisposable

Exemples

L’exemple de code suivant illustre l’utilisation de ce type. Pour plus d’informations sur cet exemple, consultez Guide pratique pour ajouter des info-bulles à des cellules individuelles dans un contrôle DataGridView Windows Forms.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}

' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

Remarques

La DataGridViewCell classe représente une cellule individuelle dans un DataGridView contrôle. Vous pouvez récupérer des cellules via la Cells collection d’un DataGridViewRow.

La ligne et la colonne d’un DataGridViewCell identifient l’emplacement de la cellule dans le DataGridView. Une cellule classique contient des données spécifiques à la ligne et à la colonne dans laquelle elle est contenue. La cellule peut être personnalisée de plusieurs façons en définissant ses propriétés et en gérant les événements qui lui sont associés.

Notes pour les responsables de l’implémentation

Lorsque vous dérivez de DataGridViewCell 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

DataGridViewCell()

Initialise une nouvelle instance de la classe DataGridViewCell.

Propriétés

AccessibilityObject	Obtient le DataGridViewCell.DataGridViewCellAccessibleObject assigné à DataGridViewCell.
ColumnIndex	Obtient l'index de colonne pour cette cellule.
ContentBounds	Obtient le rectangle englobant qui définit la zone de contenu de la cellule.
ContextMenuStrip	Obtient ou définit le menu contextuel associé à la cellule.
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.
Displayed	Obtient une valeur qui indique si la cellule est actuellement affichée à l’écran.
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.
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.
ErrorText	Obtient ou définit le texte qui décrit une condition d'erreur associée à la cellule.
FormattedValue	Obtient la valeur de la cellule telle qu'elle est mise en forme pour l'affichage.
FormattedValueType	Obtient le type de la valeur mise en forme associée à la cellule.
Frozen	Obtient une valeur indiquant si la cellule est figée.
HasStyle	Obtient une valeur indiquant si la propriété Style a été définie.
InheritedState	Obtient l'état actuel de la cellule tel qu'il est hérité de l'état de sa ligne ou colonne.
InheritedStyle	Obtient le style actuellement appliqué à la cellule.
IsInEditMode	Obtient une valeur indiquant si cette cellule est actuellement en cours de modification.
OwningColumn	Obtient la colonne qui contient cette cellule.
OwningRow	Obtient la ligne qui contient cette cellule.
PreferredSize	Obtient la taille, en pixels, d'une zone rectangulaire qui peut contenir la cellule.
ReadOnly	Obtient ou définit une valeur indiquant si les données de la cellule peuvent être modifiées.
Resizable	Obtient une valeur indiquant si la cellule peut être redimensionnée.
RowIndex	Obtient l'index de la ligne parente de la cellule.
Selected	Obtient ou définit une valeur indiquant si la cellule a été sélectionnée.
Size	Obtient la taille de la cellule.
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.
Tag	Obtient ou définit l'objet qui contient les données supplémentaires relatives à la cellule.
ToolTipText	Obtient ou définit le texte d'info-bulle associé à cette cellule.
Value	Obtient ou définit la valeur associée à cette cellule.
ValueType	Obtient ou définit 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.

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.
BorderWidths(DataGridViewAdvancedBorderStyle)	Retourne Rectangle qui représente les largeurs de toutes les marges de cellule.
ClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne de la cellule est partagée ou non lorsque l'utilisateur clique sur la cellule.
Clone()	Crée une copie exacte de cette cellule.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne de la cellule est partagée ou non lorsque l'utilisateur clique sur le contenu de la cellule.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne de la cellule est partagée ou non lorsque l'utilisateur double-clique sur le contenu de la cellule.
CreateAccessibilityInstance()	Crée un objet accessible pour le DataGridViewCell.
DetachEditingControl()	Supprime le contrôle d’édition de la cellule de DataGridView.
Dispose()	Libère toutes les ressources utilisées par DataGridViewCell.
Dispose(Boolean)	Libère les ressources non managées utilisées par DataGridViewCell et libère éventuellement les ressources managées.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indique si la ligne de la cellule est partagée ou non lorsque l'utilisateur double-clique sur la cellule.
EnterUnsharesRow(Int32, Boolean)	Indique si la ligne parente est partagée ou non lorsque le focus est déplacé vers la cellule.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Finalize()	Libère les ressources non managées et effectue d'autres opérations de nettoyage avant que DataGridViewCell ne soit récupéré par l'opération garbage collection.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Récupère la valeur mise en forme de la cellule à copier dans Clipboard.
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.
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.
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.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Obtient la valeur de la cellule telle qu'elle est mise en forme pour l'affichage.
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.
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.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Obtient le style appliqué à la cellule.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcule la taille par défaut, en pixels, de la cellule.
GetSize(Int32)	Obtient la taille de la cellule.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(Int32)	Obtient la valeur de la cellule.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Initialise le contrôle utilisé pour modifier la cellule.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indique si la ligne parente est partagée ou non lorsque l'utilisateur appuie sur une touche alors que le focus est placé sur la cellule.
KeyEntersEditMode(KeyEventArgs)	Détermine si le mode édition doit être démarré en fonction de la touche donnée.
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.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indique si la ligne parente est partagée ou non lorsque l’utilisateur relâche une touche alors que le focus est placé sur la cellule.
LeaveUnsharesRow(Int32, Boolean)	Indique si une ligne est partagée ou non lorsque le focus quitte une cellule de la ligne.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Obtient la hauteur, en pixels, du texte spécifié, en fonction des caractéristiques indiquées.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Obtient la hauteur, en pixels, du texte spécifié, en fonction des caractéristiques indiquées. Indique également si la largeur requise est supérieure à la largeur maximale spécifiée.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Obtient la hauteur et la largeur idéales du texte spécifié en fonction des caractéristiques indiquées.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Obtient la hauteur et la largeur du texte spécifié en fonction des caractéristiques indiquées.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Obtient la largeur, en pixels, du texte spécifié, en fonction des caractéristiques indiquées.
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.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si une ligne est partagée ou non lorsque l'utilisateur double-clique sur une cellule de la ligne.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si une ligne est partagée ou non lorsque l'utilisateur appuie sur le bouton de la souris alors que le pointeur est placé sur une cellule de la ligne.
MouseEnterUnsharesRow(Int32)	Indique si une ligne est partagée ou non lorsque le pointeur de la souris se déplace sur une cellule de la ligne.
MouseLeaveUnsharesRow(Int32)	Indique si une ligne est partagée ou non lorsque le pointeur de la souris s'écarte de la ligne.
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.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indique si une ligne est partagée ou non lorsque l’utilisateur relâche le bouton de la souris alors que le pointeur est placé sur une cellule de la ligne.
OnClick(DataGridViewCellEventArgs)	Appelé à la suite d'un clic sur la cellule.
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.
OnDoubleClick(DataGridViewCellEventArgs)	Appelé à la suite d'un double-clic sur la cellule.
OnEnter(Int32, Boolean)	Appelé quand le focus se déplace vers une cellule.
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.
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.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Appelé lorsque l'utilisateur double-clique sur le bouton de la souris alors que le pointeur est placé sur une cellule.
OnMouseDown(DataGridViewCellMouseEventArgs)	Appelé lorsque l'utilisateur appuie sur le bouton de la souris alors que le pointeur est placé sur une cellule.
OnMouseEnter(Int32)	Appelé lorsque le pointeur de la souris se déplace sur une cellule.
OnMouseLeave(Int32)	Appelée lorsque le pointeur de la souris s'écarte de la cellule.
OnMouseMove(DataGridViewCellMouseEventArgs)	Appelé lorsque le pointeur de la souris se déplace dans une cellule.
OnMouseUp(DataGridViewCellMouseEventArgs)	Appelée quand l’utilisateur relâche un bouton de la souris alors que le pointeur est placé sur une cellule.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Peint le DataGridViewCell actif.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Peint la bordure du DataGridViewCell actuel.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Peint l'icône d'erreur du DataGridViewCell actif.
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.
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.
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.
ToString()	Retourne une chaîne qui décrit l’objet actif.

S’applique à