ToolStrip.AutoSize 属性


获取或设置一个值,该值指示是否自动调整控件的大小以显示其完整内容。Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

 virtual property bool AutoSize { bool get(); void set(bool value); };
public override bool AutoSize { get; set; }
member this.AutoSize : bool with get, set
Public Overrides Property AutoSize As Boolean


如果控件调整宽度以完整显示内容,值为 true;反之,值为 falsetrue if the control adjusts its width to closely fit its contents; otherwise, false. 默认值为 trueThe default is true.



下面的代码示例演示了用于设置常用 ToolStrip 属性(包括 AutoSize 属性)的语法。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[] {
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


如果将 AutoSize 设置为 false 并且 ToolStrip 嵌入 ToolStripContainer 面板中,则将 ToolStrip 移到 ToolStrip 的不同面板中时,不会转换 ToolStripContainer的边界。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. 若要正确地转换边界,请同步 LayoutStyleChanged 事件,检查 Orientation 属性的值,并调整 ToolStrip大小。To translate the bounds properly, synchronize the LayoutStyleChanged event, check the value of the Orientation property, and resize the ToolStrip.

ImageImageAlignImageIndexImageKeyImageScaling 属性与图像处理的各个方面相关。The Image, ImageAlign, ImageIndex, ImageKey, and ImageScaling properties pertain to various aspects of image handling. 通过直接设置这些属性或通过设置仅运行时 ImageList 属性,使用 ToolStrip 控件中的图像。Use images in ToolStrip controls by setting these properties directly or by setting the run-time-only ImageList property.

图像缩放由 ToolStripToolStripItem中的属性交互确定,如下所示:Image scaling is determined by the interaction of properties in both ToolStrip and ToolStripItem, as follows: