DockStyle Enumeración

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

DockStyle.cs

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

public enum class DockStyle

public enum DockStyle

type DockStyle = 

Public Enum DockStyle

Herencia

Object

ValueType

Enum

DockStyle

Campos

Nombre	Valor	Description
None	0	El control no está acoplado.
Top	1	El borde superior del control se acopla a la parte superior de su control contenedor.
Bottom	2	El borde inferior del control se acopla a la parte inferior de su control contenedor.
Left	3	El borde izquierdo del control se acopla al borde izquierdo de su control contenedor.
Right	4	El borde derecho del control se acopla al borde derecho de su control contenedor.
Fill	5	Todos los bordes del control se acoplan a todos los bordes de su control contenedor y tienen el tamaño adecuado.

Ejemplos

En el ejemplo siguiente se crea y GroupBox se establecen algunas de sus propiedades comunes. En el ejemplo se crea un TextBox y se establece su Location dentro del cuadro de grupo. A continuación, establece la Text propiedad del cuadro de grupo y acopla el cuadro de grupo a 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 más altos 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