ToolStripItem.Image Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece la imagen que se muestra en un control 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

Valor de propiedad

Image

Image que se va a mostrar.

Ejemplos

En el ejemplo de código siguiente se muestran las Imagepropiedades , ImageAlign, DisplayStyle y TextAlign de .ToolStripButton Este ejemplo forma parte de un ejemplo más grande disponible en la información general de la ToolStripButton clase.

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

Comentarios

Las propiedades Image, ImageAlign, ImageIndex, ImageKey y ImageScaling tienen que ver con diversos aspectos del control de imágenes. Use imágenes en ToolStrip controles estableciendo estas propiedades directamente o estableciendo la propiedad solo ImageList en tiempo de ejecución.

El escalado de imágenes viene determinado por la interacción de las propiedades tanto en ToolStrip como en ToolStripItem, como se indica a continuación:

• ImageScalingSize es la escala de la imagen final según viene determinada por la combinación de la configuración de ImageScaling la imagen y la configuración de AutoSize del contenedor.

  • Si AutoSize es true (valor predeterminado) y ToolStripItemImageScaling es SizeToFit, no se produce ningún escalado de imagen y el tamaño de ToolStrip es el del elemento más grande, o bien un tamaño mínimo prescrito.

  • Si AutoSize es false y ToolStripItemImageScaling son None, no se produce ningún escalado de imagen ni de ToolStrip.