Partager via


ToolStripItem.ImageIndex Propriété

Définition

Obtient ou définit la valeur d'index de l'image qui s'affiche sur l'élément.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("Owner.ImageList")]
public int ImageIndex { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("Owner.ImageList")>]
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

Valeur de propriété

Int32

Index de base zéro de l'image dans ImageList affiché pour l'élément. La valeur par défaut est -1, ce qui signifie que la liste d'images est vide.

Attributs

Exceptions

value est inférieur à -1.

Remarques

ImageKey et ImageIndex sont mutuellement exclusifs, ce qui signifie que si l’un est défini, l’autre est défini sur une valeur non valide et ignoré. Si vous définissez la ImageKey propriété, la ImageIndex propriété est automatiquement définie sur -1. Sinon, si vous définissez la ImageIndex propriété, celle-ci ImageKey est automatiquement définie sur une chaîne vide («  »).

Les Imagepropriétés , , et ImageKeyImageAlignImageIndexImageScaling les propriétés se rapportent à différents aspects de la gestion des images. Utilisez des images dans des contrôles en ToolStrip définissant ces propriétés directement ou en définissant la propriété run-time uniquement ImageList .

La mise à l’échelle de l’image est déterminée par l’interaction des propriétés dans les deux ToolStrip et ToolStripItem, comme suit :

Si la ImageList valeur de la propriété est modifiée null, la ImageIndex propriété retourne sa valeur par défaut, -1. Toutefois, la valeur affectée ImageIndex est conservée en interne et utilisée lorsqu’un autre ImageList objet est affecté à la ImageList propriété. Si le nouveau ImageList affecté à la ImageList propriété a une ImageList.ImageCollection.Count valeur de propriété inférieure ou égale à la valeur affectée à la ImageIndex propriété moins une (pour tenir compte de la collection en tant qu’index de base zéro), la ImageIndex valeur de propriété est ajustée à une valeur inférieure à celle de la Count propriété. Par exemple, considérez un contrôle de bouton dont ImageList trois images et dont ImageIndex la propriété est définie sur 2. Si une nouvelle ImageList image n’a que deux images sont affectées au bouton, la ImageIndex valeur passe à 1.

S’applique à