DockStyle Enumeración

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Especifica la posición y la forma en la que se acopla un control.

public enum class DockStyle

public enum DockStyle

type DockStyle = 

Public Enum DockStyle

Herencia

Object

ValueType

Enum

DockStyle

Campos

Bottom	2	El margen inferior del control se acopla al margen inferior de su control contenedor.
Fill	5	Todos los bordes del control se acoplan a los bordes de su control contenedor y se cambian de tamaño de forma pertinente.
Left	3	El margen izquierdo del control se acopla al margen izquierdo de su control contenedor.
None	0	El control no se acopla.
Right	4	El margen derecho del control se acopla al margen derecho de su control contenedor.
Top	1	El margen superior del control se acopla al margen superior de su control contenedor.

Ejemplos

En el ejemplo 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

Cuando un control se acopla a un borde de su contenedor, siempre se coloca el vaciado en ese borde cuando se cambia el tamaño del contenedor. Si hay más de un control acoplado a un borde, los controles aparecen en paralelo según su orden z; los controles superiores en el orden z se colocan más lejos del borde del contenedor.

Si se selecciona Izquierda, Derecha, Superior o Inferior, se cambia el tamaño de los bordes especificados y opuestos del control al tamaño de los bordes correspondientes del control contenedor. Si se selecciona Relleno, se cambia el tamaño de los cuatro lados del control para que coincidan con los bordes del control contenedor.

Consulte también

• Dock