ToolStripItem.Image Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das in ToolStripItem dargestellte Bild ab oder legt dieses fest.

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

Eigenschaftswert

Image

Das anzuzeigende Image.

Beispiele

Im folgenden Codebeispiel werden die ImageEigenschaften , ImageAlign, DisplayStyle und TextAlign für eine ToolStripButtonveranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das in der ToolStripButton Klassenübersicht verfügbar ist.

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

Hinweise

Die Eigenschaften Image, ImageAlign, ImageIndex, ImageKey und ImageScaling beziehen sich auf verschiedene Aspekte der Bildbehandlung. Verwenden Sie Bilder in ToolStrip Steuerelementen, indem Sie diese Eigenschaften direkt oder durch Festlegen der Laufzeiteigenschaft festlegen ImageList .

Die Bildskalierung wird durch die Interaktion von Eigenschaften in ToolStrip und ToolStripItem wie folgt bestimmt:

• ImageScalingSize ist die Skalierung des endgültigen Bilds, die sich aus der Kombination der ImageScaling-Einstellung des Bilds und der AutoSize-Einstellung des Containers ergibt.

  • Wenn AutoSize entsprechend true (die Standardeinstellung) und ToolStripItemImageScalingSizeToFit ist, erfolgt keine Skalierung des Bilds und die ToolStrip-Größe entspricht der des größten Elements oder einer vorgegebenen Mindestgröße.

  • Wenn AutoSize entsprechend false und ToolStripItemImageScaling wiederum None ist, werden weder Bild noch ToolStrip skaliert.