ToolStrip.ImageScalingSize Eigenschap

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

Waarde van eigenschap

Een Size waarde die de grootte van de afbeelding weergeeft, in pixels. De standaardwaarde is 16 x 16 pixels.

Voorbeelden

In het volgende codevoorbeeld ziet u de syntaxis voor het instellen van algemene ToolStrip eigenschappen, inclusief de ImageScalingSize eigenschap.

// 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

Opmerkingen

Gebruik de ToolStripItemImageScaling eigenschap om de standaardgrootte van een afbeelding te bepalen. Gebruik SizeToFit dit om de grootte van de afbeelding op een ToolStripItem te maken om automatisch aan te passen aan een ToolStrip afbeelding terwijl de oorspronkelijke afbeeldingsverhoudingen behouden blijven.

De eigenschappen Image, ImageAlign, ImageIndex, ImageKeyen ImageScaling hebben betrekking op verschillende aspecten van de verwerking van afbeeldingen. Gebruik afbeeldingen in ToolStrip besturingselementen door deze eigenschappen rechtstreeks in te stellen of door de eigenschap alleen-runtime ImageList in te stellen.

Het schalen van afbeeldingen wordt als volgt bepaald door de interactie van eigenschappen in zowel ToolStrip als ToolStripItem:

• ImageScalingSize is de schaal van de uiteindelijke afbeelding, zoals bepaald door de combinatie van de ImageScaling-instelling van de afbeelding en de AutoSize-instelling van de container.

  • Als AutoSize is true (de standaardinstelling) en ToolStripItemImageScaling is SizeToFit, treedt er geen schaalaanpassing van afbeeldingen op en is de ToolStrip grootte dat van het grootste item of een voorgeschreven minimale grootte.

  • Als AutoSizefalse is en ToolStripItemImageScalingNoneis, vinden noch afbeelding noch ToolStrip schalen plaats.