ToolStripItem.Image Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit l'image affichée sur un ToolStripItem.

public:
 virtual property System::Drawing::Image ^ Image { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };

public virtual System.Drawing.Image? Image { get; set; }

member this.Image : System.Drawing.Image with get, set

Public Overridable Property Image As Image

Valeur de propriété

Image

Image à afficher.

Exemples

L’exemple de code suivant illustre les Imagepropriétés , ImageAlign, DisplayStyle et TextAlign d’un ToolStripButton. Cet exemple fait partie d’un exemple plus large disponible dans la vue d’ensemble de la ToolStripButton classe.

this.toolStripButton1.Image = Bitmap.FromFile("c:\\NewItem.bmp");
this.toolStripButton1.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.ImageAndText;
this.toolStripButton1.ImageAlign = System.Drawing.ContentAlignment.MiddleLeft;
this.toolStripButton1.Name = "toolStripButton1";
this.toolStripButton1.Text = "&New";
this.toolStripButton1.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
this.toolStripButton1.Click += new System.EventHandler(this.toolStripButton1_Click);

Me.toolStripButton1.Image = Bitmap.FromFile("c:\NewItem.bmp")
Me.toolStripButton1.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.ImageAndText
Me.toolStripButton1.ImageAlign = System.Drawing.ContentAlignment.MiddleLeft
Me.toolStripButton1.Name = "toolStripButton1"
Me.toolStripButton1.Text = "&New"
Me.toolStripButton1.TextAlign = System.Drawing.ContentAlignment.MiddleRight

Remarques

Les Imagepropriétés , ImageAlign, ImageIndex, ImageKeyet ImageScaling se rapportent à différents aspects de la gestion des images. Utilisez des images dans les contrôles en ToolStrip définissant ces propriétés directement ou en définissant la propriété d’exécution uniquement ImageList .

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

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

  • Si AutoSize est true (la valeur par défaut) et ToolStripItemImageScaling est SizeToFit, aucune mise à l’échelle d’image n’a lieu et la ToolStrip taille est celle de l’élément le plus volumineux ou d’une taille minimale prescrite.

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