ToolStrip.Dock Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft ab oder legt fest, welche ToolStrip-Rahmen am übergeordneten Steuerelement angedockt sind, und bestimmt, wie die Größe eines ToolStrip mit dem übergeordneten Steuerelement geändert wird.

public:
 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

Eigenschaftswert

DockStyle

Einer der DockStyle-Werte. Der Standardwert ist Top.

Beispiele

Das folgende Codebeispiel veranschaulicht die Syntax zum Festlegen allgemeiner ToolStrip Eigenschaften, einschließlich der Dock -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 Dock -Eigenschaft, um zu definieren, wie die Größe eines ToolStrip automatisch geändert wird, wenn die Größe des übergeordneten Steuerelements geändert wird. Wenn Sie z. B. auf Left festlegen, Dock wird der ToolStrip sich an den linken Rändern des übergeordneten Steuerelements ausrichten und die Größe des übergeordneten Steuerelements ändern. Steuerelemente werden in ihrer z-Reihenfolge angedockt, d. r. die visuelle Schichtung von Steuerelementen auf einem Formular entlang der Z-Achse (Tiefe) des Formulars.

Ein Steuerelement kann an einen Rand des übergeordneten Containers angedockt oder an alle Kanten angedockt werden und den übergeordneten Container füllen.

Wenn sich das ToolStrip Steuerelement in einem ToolStripPanelbefindet, kann das ToolStrip innerhalb von ToolStripPanel und über ToolStripPanels neu positioniert werden. Die Dock-Eigenschaft wird ignoriert, und wenn die Stretch-Eigenschaft false lautet, nimmt die Größe von ToolStrip zu, wenn Elemente dem ToolStripPanel hinzugefügt werden. Normalerweise ist ToolStrip nicht an der Aktivierreihenfolge beteiligt.

Hinweis

Die Anchor Eigenschaften und Dock schließen sich gegenseitig aus. Nur eine kann gleichzeitig festgelegt werden, und der letzte Satz hat Vorrang.

Weitere Informationen

• Vorgehensweise: Definieren der Z-Reihenfolge angedockter ToolStrip-Steuerelemente