ToolStrip.ImageScalingSize Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

ToolStrip.cs

Ruft die Größe eines auf einem ToolStrip-Objekt verwendeten Bilds in Pixel ab oder legt sie fest.

public System.Drawing.Size ImageScalingSize { get; set; }

Eigenschaftswert

Size

Ein Size-Wert, der die Größe des Bilds in Pixel darstellt. Der Standardwert ist 16 x 16 Pixel.

Beispiele

Das folgende Codebeispiel veranschaulicht die Syntax zum Festlegen allgemeiner ToolStrip Eigenschaften, einschließlich der ImageScalingSize -Eigenschaft.

// This is an example of some common ToolStrip property settings.
// 
toolStrip1.AllowDrop = false;
toolStrip1.AllowItemReorder = true;
toolStrip1.AllowMerge = false;
toolStrip1.Anchor = ((System.Windows.Forms.AnchorStyles)(((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Left)
            | System.Windows.Forms.AnchorStyles.Right)));
toolStrip1.AutoSize = false;
toolStrip1.CanOverflow = false;
toolStrip1.Cursor = System.Windows.Forms.Cursors.Cross;
toolStrip1.DefaultDropDownDirection = System.Windows.Forms.ToolStripDropDownDirection.BelowRight;
toolStrip1.Dock = System.Windows.Forms.DockStyle.None;
toolStrip1.GripMargin = new System.Windows.Forms.Padding(3);
toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
toolStripButton1});
toolStrip1.ImageScalingSize = new System.Drawing.Size(20, 20);
toolStrip1.LayoutStyle = System.Windows.Forms.ToolStripLayoutStyle.HorizontalStackWithOverflow;
toolStrip1.Location = new System.Drawing.Point(0, 0);
toolStrip1.Margin = new System.Windows.Forms.Padding(1);
toolStrip1.Name = "toolStrip1";
toolStrip1.Padding = new System.Windows.Forms.Padding(0, 0, 2, 0);
toolStrip1.RenderMode = System.Windows.Forms.ToolStripRenderMode.System;
toolStrip1.ShowItemToolTips = false;
toolStrip1.Size = new System.Drawing.Size(109, 273);
toolStrip1.Stretch = true;
toolStrip1.TabIndex = 0;
toolStrip1.TabStop = true;
toolStrip1.Text = "toolStrip1";
toolStrip1.TextDirection = System.Windows.Forms.ToolStripTextDirection.Vertical90;

Hinweise

Verwenden Sie die ToolStripItemImageScaling -Eigenschaft, um die Standardgröße eines Bilds zu steuern. Verwenden Sie SizeToFit , um die Größe des Bilds auf einem ToolStripItem so zu gestalten, dass es automatisch angepasst wird ToolStrip , während die ursprünglichen Bildproportionen beibehalten werden.

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.

Gilt für: