Control.Dock Control.Dock Control.Dock Control.Dock Property

Definición

Obtiene o establece que los bordes del control se acoplarán a su control primario y determina cómo se cambia el tamaño de un control con su elemento primario.Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

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

Valor de propiedad

Uno de los valores de DockStyle.One of the DockStyle values. De manera predeterminada, es None.The default is None.

Excepciones

El valor asignado no es uno de los valores de DockStyle.The value assigned is not one of the DockStyle values.

Ejemplos

En el ejemplo de código siguiente se crea un GroupBox y se establecen algunas de sus propiedades comunes.The following code example creates a GroupBox and sets some of its common properties. El ejemplo se crea un TextBox y establece su Location dentro del cuadro de grupo.The example creates a TextBox and sets its Location within the group box. A continuación, Establece la Text propiedad del cuadro de grupo y lo acopla el grupo de cuadro a la parte superior del formulario.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Por último, deshabilita el cuadro de grupo estableciendo el Enabled propiedad false, lo que hace que todos los controles contenidos en el cuadro de grupo va a deshabilitar.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }
// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}
' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

Comentarios

Use el Dock propiedad para definir cómo se cambia automáticamente el tamaño de un control cuando se cambia el tamaño de su control primario.Use the Dock property to define how a control is automatically resized as its parent control is resized. Por ejemplo, si se establece Dock a DockStyle.Left hace que el control para alinearse con los bordes izquierdos de su control primario y cambia de tamaño cuando se cambia el tamaño del control primario.For example, setting Dock to DockStyle.Left causes the control to align itself with the left edges of its parent control and to resize as the parent control is resized. Los controles se acoplan en su orden Z, que es el diseño visual de los controles en un formulario a lo largo del eje z del formulario (profundidad).Controls are docked in their Z-order, which is the visual layering of controls on a form along the form's Z-axis (depth).

Un control se puede acoplar a uno de los bordes de su contenedor primario o se puede acoplar a todos los bordes y rellene el contenedor primario.A control can be docked to one edge of its parent container or can be docked to all edges and fill the parent container.

Establecer el Margin propiedad en un control acoplado no tiene ningún efecto en la distancia del control de los bordes de su contenedor.Setting the Margin property on a docked control has no effect on the distance of the control from the edges of its container.

Nota

El Anchor y Dock propiedades son mutuamente excluyentes.The Anchor and Dock properties are mutually exclusive. Solo una puede establecerse en un momento, y el último conjunto tiene prioridad.Only one can be set at a time, and the last one set takes precedence.

Notas a los desarrolladores de herederos

Cuando se reemplaza el Dock propiedad en una clase derivada, utilice la clase base Dock propiedad para extender la implementación base.When overriding the Dock property in a derived class, use the base class's Dock property to extend the base implementation. En caso contrario, debe proporcionar toda la implementación.Otherwise, you must provide all the implementation. No es necesario reemplazar ambos el get y set métodos de la Dock propiedad; se puede reemplazar sólo uno, si es necesario.You are not required to override both the get and set methods of the Dock property; you can override only one if needed.

Se aplica a

Consulte también: