Actualización: noviembre 2007
Especifica la posición y la forma en la que se acopla un control.
Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms (en System.Windows.Forms.dll)

Sintaxis
Visual Basic (Declaración)
Public Enumeration DockStyle
Dim instance As DockStyle
public enum class DockStyle

Comentarios
Cuando se acopla un control a uno de los bordes de su contenedor, siempre se coloca con una sangría respecto al borde al cambiar de tamaño el contenedor. Si hay más de un control acoplado a un borde, los controles aparecen juntos según su orden z; los controles superiores del orden z se colocan más lejos del borde del contenedor.
Si se selecciona Left, Right, Top o Bottom, se cambia el tamaño de los bordes especificados y opuestos del control hasta que sean iguales al de los bordes del control contenedor. Si se selecciona Fill, se cambia el tamaño de los cuatro laterales del control para que coincidan con los bordes del control contenedor.

Ejemplos
En el ejemplo siguiente se crea un GroupBox y se establecen algunas de sus propiedades comunes. En el ejemplo se crea un objeto TextBox y se establece su propiedad Location dentro del cuadro de grupo. A continuación, establece la propiedad Text del cuadro de grupo y lo acopla a la parte superior del formulario. Por último, deshabilita el cuadro de grupo estableciendo la propiedad Enabled en false, con lo que todos los controles contenidos en el cuadro de grupo se deshabilitan.
' 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
// 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:
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.set_Location(new Point(15, 15));
groupBox1.get_Controls().Add(textBox1);
// Set the Text and Dock properties of the GroupBox.
groupBox1.set_Text("MyGroupBox");
groupBox1.set_Dock(DockStyle.Top);
// Disable the GroupBox (which disables all its child controls)
groupBox1.set_Enabled(false);
// Add the Groupbox to the form.
this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

Plataformas
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión
.NET Framework
Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 3.5, 2.0

Vea también