Exportar (0) Imprimir
Expandir todo
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Control.Dock (Propiedad)

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; }

Valor de propiedad

Tipo: System.Windows.Forms.DockStyle
Uno de los valores de DockStyle. El tipo 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.

NotaNota

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 objeto 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, 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);
}


.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft