ToolStripItem.ImageIndex Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Exceptions

ArgumentOutOfRangeException

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 :

• ImageScalingSize est l’échelle de l’image finale, déterminée par la combinaison du paramètre de ImageScaling l’image et du paramètre du AutoSize conteneur.

  • Si AutoSize elle est true (valeur par défaut) et ToolStripItemImageScaling SizeToFitqu’aucune mise à l’échelle d’image ne se produit, et la ToolStrip taille est celle du plus grand élément ou d’une taille minimale prescrite.

  • Si AutoSize c’est et ToolStripItemImageScaling est false None, ni l’image ni ToolStrip la mise à l’échelle ne se produisent.

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.