ToolStrip.ImageScalingSize 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 die Größe eines Bilds in Pixeln ab, das für ein ToolStripBild verwendet wird, oder legt diese fest.
public:
property System::Drawing::Size ImageScalingSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size ImageScalingSize { get; set; }
member this.ImageScalingSize : System.Drawing.Size with get, set
Public Property ImageScalingSize As Size
Eigenschaftswert
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;
' This is an example of some common ToolStrip property settings.
'
toolStrip1.AllowDrop = False
toolStrip1.AllowItemReorder = True
toolStrip1.AllowMerge = False
toolStrip1.Anchor = CType(System.Windows.Forms.AnchorStyles.Top Or System.Windows.Forms.AnchorStyles.Left Or System.Windows.Forms.AnchorStyles.Right, System.Windows.Forms.AnchorStyles)
toolStrip1.AutoSize = False
toolStrip1.CanOverflow = False
toolStrip1.Cursor = Cursors.Cross
toolStrip1.Dock = System.Windows.Forms.DockStyle.None
toolStrip1.DefaultDropDownDirection = ToolStripDropDownDirection.BelowRight
toolStrip1.GripMargin = New System.Windows.Forms.Padding(3)
toolStrip1.ImageScalingSize = New System.Drawing.Size(20, 20)
toolStrip1.Items.AddRange(New System.Windows.Forms.ToolStripItem() {toolStripButton1})
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 diese Einstellung SizeToFit , um die Größe des Bilds auf einem ToolStripItem Bild automatisch anzupassen und gleichzeitig ToolStrip die ursprünglichen Bildproportionen beizubehalten.
Die Image, ImageAlign, ImageIndex, ImageKeyund ImageScaling Eigenschaften beziehen sich auf verschiedene Aspekte der Bildverarbeitung. Verwenden Sie Bilder in ToolStrip Steuerelementen, indem Sie diese Eigenschaften direkt oder durch Festlegen der Nur-Laufzeit-Eigenschaft ImageList festlegen.
Die Bildskalierung wird durch die Interaktion von Eigenschaften in beiden ToolStrip und ToolStripItemwie folgt bestimmt:
ImageScalingSize ist die Skalierung des endgültigen Bildes, bestimmt durch die Kombination der Einstellung des ImageScaling Bildes und der Einstellung des Containers AutoSize.
Wenn AutoSize
true(Standard) ist und ToolStripItemImageScalingSizeToFit ist, erfolgt keine Bildskalierung, und die Größe von ToolStrip entspricht der des größten Elements oder einer vorgeschriebenen Mindestgröße.Wenn AutoSize
falseist und ToolStripItemImageScalingNone ist, tritt weder die Bild- noch die ToolStrip-Skalierung auf.