Compartir a través de


Control.Dock Propiedad

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.

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. De manera predeterminada, es None.

Excepciones

El valor asignado no es uno de los valores de DockStyle.

Ejemplos

En el ejemplo de código siguiente se crea y GroupBox se establecen algunas de sus propiedades comunes. En el ejemplo se crea un TextBox objeto y se establece Location dentro del cuadro de grupo. A continuación, establece la Text propiedad del cuadro de grupo y acopla el cuadro de grupo en la parte superior del formulario. Por último, deshabilita el cuadro de grupo estableciendo la Enabled propiedad falseen , lo que hace que todos los controles contenidos en el cuadro de grupo se deshabiliten.

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

Utilice la propiedad para definir cómo se cambia automáticamente el Dock tamaño de un control a medida que se cambia el tamaño de su control primario. Por ejemplo, establecer Dock en DockStyle.Left hace que el control se 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.

Establecer la Margin propiedad en un control acoplado no tiene ningún efecto en la distancia del control desde los bordes de su contenedor.

Nota:

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

Notas a los desarrolladores de herederos

Al invalidar la Dock propiedad en una clase derivada, utilice la propiedad de Dock la clase base para extender la implementación base. De lo contrario, debe proporcionar toda la implementación. No es necesario invalidar los get métodos y set de la Dock propiedad; solo puede invalidar uno si es necesario.

Se aplica a

Consulte también