DataGridViewImageCell Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Affiche un graphique dans un contrôle DataGridView.

public ref class DataGridViewImageCell : System::Windows::Forms::DataGridViewCell

public class DataGridViewImageCell : System.Windows.Forms.DataGridViewCell

type DataGridViewImageCell = class
    inherit DataGridViewCell

Public Class DataGridViewImageCell
Inherits DataGridViewCell

Héritage

Object

DataGridViewElement

DataGridViewCell

DataGridViewImageCell

Exemples

L’exemple de code suivant montre comment modifier l’image dans une cellule d’image à l’aide DataGridViewCellde . Cet exemple de code fait partie d’un exemple plus large fourni pour la rubrique How to: Work with Image Columns in the Windows Forms DataGridView Control.

void dataGridView1_CellClick( Object^ sender, DataGridViewCellEventArgs^ e )
{
   if ( turn->Equals( gameOverString ) )
   {
      return;
   }

   DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
   if ( cell->Value == blank )
   {
      if ( IsOsTurn() )
      {
         cell->Value = o;
      }
      else
      {
         cell->Value = x;
      }

      ToggleTurn();
   }

   if ( IsAWin( cell ) )
   {
      turn->Text = gameOverString;
   }
}

private void dataGridView1_CellClick(object sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return; }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}

Private Sub dataGridView1_CellClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellClick

    If turn.Text.Equals(gameOverString) Then Return

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex), DataGridViewImageCell)
    If (cell.Value Is blank) Then
        If IsOsTurn() Then
            cell.Value = o
        Else
            cell.Value = x
        End If
        ToggleTurn()
        ToolTip(e)
    End If
    If IsAWin() Then
        turn.Text = gameOverString
    End If
End Sub

Remarques

La DataGridViewImageCell classe est un type spécialisé de DataGridViewCell utilisé pour afficher un Image ou un Icon, selon la valeur de la ValueIsIcon propriété . En règle générale, la ReadOnly propriété d’un DataGridViewImageCell est définie sur true pour indiquer que l’utilisateur ne peut pas modifier le contenu de la cellule.

est DataGridViewImageColumn le type de colonne spécialisé pour contenir les cellules de ce type. Par défaut, est DataGridViewImageColumn.CellTemplate initialisé dans un nouveau DataGridViewImageCell. Pour mettre en forme les cellules d’une colonne à partir d’un modèle existant DataGridViewImageCell, 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 basées sur le 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, et actualise l’affichage de la colonne si nécessaire.

Notes pour les héritiers

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

DataGridViewImageCell()	Initialise une nouvelle instance de la classe DataGridViewImageCell, en la configurant pour l'utiliser avec des valeurs de cellule différentes des objets Icon.
DataGridViewImageCell(Boolean)	Initialise une nouvelle instance de la classe DataGridViewImageCell, en la configurant éventuellement pour l'utiliser avec les valeurs de cellule Icon.

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 qui est utilisée lors de la création d'une nouvelle ligne.
Description	Obtient ou définit le texte associé à l'image.
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)
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)
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 de la valeur mise en forme associée à 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)
ImageLayout	Obtient ou définit la disposition de l'image pour la cellule.
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)
ToolTipText	Obtient ou définit le texte d'info-bulle associé à cette cellule. (Hérité de DataGridViewCell)
Value	Obtient ou définit la valeur associée à cette cellule. (Hérité de DataGridViewCell)
ValueIsIcon	Obtient ou définit une valeur indiquant si la cellule affiche une valeur Icon.
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. (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 la ligne de la cellule est partagée ou non lorsque l'utilisateur clique sur le contenu de la cellule. (Hérité de DataGridViewCell)
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. (Hérité de DataGridViewCell)
CreateAccessibilityInstance()	Crée un objet accessible pour le DataGridViewImageCell.
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)
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)	Retourne une image comme elle devrait être affichée dans 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.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Initialise le contrôle utilisé pour modifier la cellule. (Hérité de DataGridViewCell)
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. (Hérité de DataGridViewCell)
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 la ligne parente est partagée ou non lorsque l’utilisateur relâche une touche alors que le focus est placé sur la cellule. (Hérité de DataGridViewCell)
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 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. (Hérité de DataGridViewCell)
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. (Hérité de DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Indique si une ligne est partagée ou non lorsque le pointeur de la souris s'écarte de la ligne. (Hérité de DataGridViewCell)
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 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. (Hérité de DataGridViewCell)
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. (Hérité de DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Appelé lorsque l'utilisateur double-clique sur le contenu de la cellule. (Hérité de DataGridViewCell)
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. (Hérité de DataGridViewCell)
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. (Hérité de DataGridViewCell)
OnLeave(Int32, Boolean)	Appelé lorsque le focus se déplace d'une cellule. (Hérité de DataGridViewCell)
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 l'utilisateur appuie sur le bouton de la souris alors que le pointeur est placé sur une cellule. (Hérité de DataGridViewCell)
OnMouseEnter(Int32)	Appelé lorsque le pointeur de la souris se déplace sur une cellule. (Hérité de DataGridViewCell)
OnMouseLeave(Int32)	Appelée lorsque le pointeur de la souris s'écarte de la cellule. (Hérité de DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Appelé lorsque le pointeur de la souris se déplace dans une cellule. (Hérité de DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Appelée quand l’utilisateur relâche un bouton de la souris alors que le pointeur est placé sur une cellule. (Hérité de DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Peint le DataGridViewImageCell 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. (Hérité de DataGridViewCell)
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)
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 une chaîne qui décrit l’objet actif.

Voir aussi

• DataGridView
• DataGridViewCell
• DataGridViewImageColumn
• CellTemplate
• Image
• Icon
• ValueIsIcon