ToolStripItem.Image Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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; }
public virtual System.Drawing.Image? Image { get; set; }
member this.Image : System.Drawing.Image with get, set
Public Overridable Property Image As Image
Eigenschaftswert
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.