Exportar (0) Imprimir
Expandir todo
Expandir Minimizar

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)

'Declaración
<LocalizableAttribute(True)> _
Public Overridable Property Dock As DockStyle
'Uso
Dim instance As Control
Dim value As DockStyle

value = instance.Dock

instance.Dock = value
/** @property */
public DockStyle get_Dock ()

/** @property */
public void set_Dock (DockStyle value)

public function get Dock () : DockStyle

public function set Dock (value : DockStyle)

No aplicable.

Valor de propiedad

Uno de los valores de DockStyle. El valor predeterminado es None.

Tipo de 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, 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 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.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 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0
Mostrar:
© 2014 Microsoft