ToolStrip.Dock Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece que los bordes del elemento ToolStrip se acoplarán a su control principal y determina cómo se cambia el tamaño de un elemento ToolStrip con su elemento primario.

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

Valor de propiedad

DockStyle

Uno de los valores de DockStyle. El valor predeterminado es Top.

Ejemplos

En el ejemplo de código siguiente se muestra la sintaxis para establecer propiedades comunes ToolStrip , incluida la Dock propiedad .

// 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

Comentarios

Utilice la propiedad para definir cómo se cambia automáticamente el Dock tamaño de un ToolStrip control a medida que se cambia el tamaño de su control primario. Por ejemplo, establecer Dock en Left hace que se ToolStrip alinee con los bordes izquierdos de su control primario y cambiar el tamaño a medida que se cambia el tamaño del control primario. Los controles se acoplan en su orden z, que es la capa visual de controles de un formulario a lo largo del eje z del formulario (profundidad).

Un control se puede acoplar a un borde de su contenedor primario o se puede acoplar a todos los bordes y rellenar el contenedor primario.

Si el ToolStrip control está en , ToolStripPanelse puede cambiar la ToolStrip posición dentro de ToolStripPanel y en ToolStripPanels. La Dock propiedad se omite y, si la Stretch propiedad es false, el tamaño de ToolStrip crece a medida que se agregan elementos a ToolStripPanel. Normalmente, no ToolStrip participa en el orden de tabulación.

Nota

Las Anchor propiedades y Dock son mutuamente excluyentes. Solo se puede establecer una a la vez y el último conjunto tiene prioridad.

Consulte también

• Procedimiento para definir el orden Z de los controles ToolStrip acoplados