ToolStrip.AutoSize Property
Gets or sets a value indicating whether the control is automatically resized to display its entire contents.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Property Value
Type: System.Booleantrue if the control adjusts its width to closely fit its contents; otherwise, false. The default is true.
If you set AutoSize to false and the ToolStrip is embedded in a ToolStripContainer panel, the bounds of the ToolStrip are not translated when you move the ToolStrip to a different panel of the ToolStripContainer. To translate the bounds properly, synchronize the LayoutStyleChanged event, check the value of the Orientation property, and resize the ToolStrip.
The Image, ImageAlign, ImageIndex, ImageKey, and ImageScaling properties pertain to various aspects of image handling. Use images in ToolStrip controls by setting these properties directly or by setting the run-time–only ImageList property.
Image scaling is determined by the interaction of properties in both ToolStrip and ToolStripItem, as follows:
ImageScalingSize is the scale of the final image as determined by the combination of the image's ImageScaling setting and the container's AutoSize setting.
If AutoSize is true (the default) and ToolStripItemImageScaling is SizeToFit, no image scaling occurs, and the ToolStrip size is that of the largest item, or a prescribed minimum size.
If AutoSize is false and ToolStripItemImageScaling is None, neither image nor ToolStrip scaling occurs.
The following code example demonstrates the syntax for setting common ToolStrip properties, including the AutoSize property.
// 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;
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
