ToolStrip.Dock ToolStrip.Dock ToolStrip.Dock ToolStrip.Dock Property


取得或設定停駐在其父控制項的 ToolStrip 框線,並決定 ToolStrip 隨其父代重新調整大小的方式。Gets or sets which ToolStrip borders are docked to its parent control and determines how a ToolStrip is resized with its parent.

 virtual property System::Windows::Forms::DockStyle Dock { System::Windows::Forms::DockStyle get(); void set(System::Windows::Forms::DockStyle value); };
public override System.Windows.Forms.DockStyle Dock { get; set; }
member this.Dock : System.Windows.Forms.DockStyle with get, set
Public Overrides Property Dock As DockStyle


其中一個 DockStyle 值。One of the DockStyle values. 預設值為 TopThe default value is Top.


下列程式碼範例示範設定通用ToolStrip屬性的語法, Dock包括屬性。The following code example demonstrates the syntax for setting common ToolStrip properties, including the Dock 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


使用屬性,即可定義ToolStrip如何自動調整其父控制項的大小。 DockUse the Dock property to define how a ToolStrip is automatically resized as its parent control is resized. 例如,將設定DockLeft ,會ToolStrip使與父控制項的左邊緣對齊,並在調整父控制項大小時調整大小。For example, setting Dock to Left causes the ToolStrip to align itself with the left edges of its parent control and to resize as the parent control is resized. 控制項停駐在其迭置順序中,也就是表單上控制項的視覺分層,沿著表單的 Z 軸(深度)。Controls are docked in their z-order, which is the visual layering of controls on a form along the form's z-axis (depth).

控制項可以停駐在其父容器的一個邊緣,也可以停駐在所有邊緣,並填滿父容器。A control can be docked to one edge of its parent container or can be docked to all edges and fill the parent container.

ToolStrip如果控制項在中ToolStripPanel ,可以在和之間ToolStripPanel重新置放。 ToolStripPanel ToolStripIf the ToolStrip control is in a ToolStripPanel, the ToolStrip can be repositioned within the ToolStripPanel and across ToolStripPanels. false ToolStrip ToolStripPanel會忽略Stretch屬性, 如果屬性為, 則的大小會隨著專案新增至而增加。 DockThe Dock property is ignored, and if the Stretch property is false, the size of the ToolStrip grows as items are added to the ToolStripPanel. 一般而言, ToolStrip不會參與定位順序。Typically, the ToolStrip does not participate in the tab order.


AnchorDock屬性互斥。The Anchor and Dock properties are mutually exclusive. 一次只能設定一個,而最後一個設定則優先。Only one can be set at a time, and the last one set takes precedence.