StatusStrip.Dock Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

StatusStrip.cs

Gets or sets which StatusStrip borders are docked to its parent control and determines how a StatusStrip is resized with its parent.

C#

public override System.Windows.Forms.DockStyle Dock { get; set; }

Property Value

DockStyle

One of the DockStyle values. The default is Bottom.

Examples

The following code example demonstrates a StatusStrip with various common properties set, including the Dock property.

C#

statusStrip1.Dock = System.Windows.Forms.DockStyle.Top;
statusStrip1.GripStyle = System.Windows.Forms.ToolStripGripStyle.Visible;
statusStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
toolStripStatusLabel1});
statusStrip1.LayoutStyle = System.Windows.Forms.ToolStripLayoutStyle.HorizontalStackWithOverflow;
statusStrip1.Location = new System.Drawing.Point(0, 0);
statusStrip1.Name = "statusStrip1";
statusStrip1.ShowItemToolTips = true;
statusStrip1.Size = new System.Drawing.Size(292, 22);
statusStrip1.SizingGrip = false;
statusStrip1.Stretch = false;
statusStrip1.TabIndex = 0;
statusStrip1.Text = "statusStrip1";

Remarks

Use the Dock property to define how a StatusStrip is automatically resized as its parent control is resized. For example, setting Dock to Left causes the StatusStrip to align itself with the left edges of its parent control and to resize as the parent control is resized. 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.

Applies to