ToolStripItem.Image Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define a imagem exibida em um 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 da propriedade

Image

O Image a ser exibido.

Exemplos

O exemplo de código a seguir demonstra as propriedades e TextAlign propriedades DisplayStyle ImageImageAlignde um .ToolStripButton Este exemplo faz parte de um exemplo maior disponível na visão geral da 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

Comentários

As Imagepropriedades , ImageAligne ImageKeyImageIndexImageScaling propriedades pertencem a vários aspectos do tratamento de imagem. Use imagens em ToolStrip controles definindo essas propriedades diretamente ou definindo a propriedade somente ImageList tempo de execução.

O dimensionamento de imagem é determinado pela interação das propriedades em ambos ToolStrip e ToolStripItem, da seguinte maneira:

• ImageScalingSize é a escala da imagem final, conforme determinado pela combinação da configuração da ImageScaling imagem e da configuração do AutoSize contêiner.

  • Se AutoSize for true (o padrão) e ToolStripItemImageScaling for SizeToFit, nenhum dimensionamento de imagem ocorrerá e o ToolStrip tamanho for o do maior item ou um tamanho mínimo prescrito.

  • Se AutoSize for false e ToolStripItemImageScaling for None, não ocorrerá imagem nem ToolStrip dimensionamento.