Exportar (0) Imprimir
Expandir todo
Expandir Minimizar

Control.Dock (Propiedad)

Actualización: noviembre 2007

Obtiene o establece que los bordes del control se acoplarán a su control principal y determina cómo se cambia el tamaño de un control con su elemento primario.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public virtual DockStyle Dock { get; set; }
/** @property */
public DockStyle get_Dock()
/** @property */
public  void set_Dock(DockStyle value)

public function get Dock () : DockStyle
public function set Dock (value : DockStyle)

Valor de propiedad

Tipo: System.Windows.Forms.DockStyle
Uno de los valores de DockStyle. El valor predeterminado es None.

ExcepciónCondición
InvalidEnumArgumentException

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

Utilice la propiedad Dock para definir cómo se cambia automáticamente el tamaño de un control cuando se cambia el tamaño de su control primario. Por ejemplo, al establecer Dock en DockStyle.Left el control se alinea a sí mismo con los bordes izquierdos de su control primario y cambia de tamaño cuando se cambia el tamaño del control primario. Los controles se acoplan en su orden z, que constituye las capas visuales de controles en un formulario a lo largo del eje Z (fondo) del formulario.

Un control puede acoplarse a uno de los bordes de su contenedor principal o a todos los bordes y llenar el contenedor principal.

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

77cb86s0.alert_note(es-es,VS.90).gifNota:

Las propiedades Anchor y Dock se excluyen mutuamente. Sólo se puede establecer una cada vez y la última establecida es la que tiene prioridad.

Notas para los herederos:

Cuando se reemplaza la propiedad Dock en una clase derivada, hay que utilizar la propiedad Dock de la clase base para extender la implementación base. Si no, deberá proporcionarse toda la implementación. No es necesario que reemplace los dos métodos get y set de la propiedad Dock; es posible reemplazar sólo uno, si es necesario.

En el ejemplo de código siguiente se crea un control GroupBox y se establecen algunas de sus propiedades comunes. En el ejemplo se crea un TextBox y se establece su propiedad Location dentro del cuadro de grupo. A continuación, se establece la propiedad Text del cuadro de grupo y se acopla el cuadro de grupo a la parte superior del formulario. Por último, se 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 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 = 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


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.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft