Shape.Anchor (Propiedad)

Artículo
11/02/2012

Obtiene o establece los bordes del contenedor al que se enlaza una forma, y determina cómo se cambia el tamaño de una forma cuando se cambia el tamaño de su elemento primario.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
Public Overridable Property Anchor As AnchorStyles

public virtual AnchorStyles Anchor { get; set; }

public:
virtual property AnchorStyles Anchor {
    AnchorStyles get ();
    void set (AnchorStyles value);
}

abstract Anchor : AnchorStyles with get, set
override Anchor : AnchorStyles with get, set

function get Anchor () : AnchorStyles
function set Anchor (value : AnchorStyles)

Valor de propiedad

Tipo: System.Windows.Forms.AnchorStyles
Combinación bit a bit de los valores de AnchorStyles.Los valores predeterminados son Top y Left.

Comentarios

Utilice la propiedad de Anchor para definir cómo una forma se ajusta automáticamente el tamaño cuando se cambia el tamaño del control principal.Proteger una forma al control principal garantiza que se conservan los bordes delimitados en la misma posición relativa a los bordes del control principal cuando se cambia el tamaño del control principal.

Se pueden delimitar una forma en uno o más bordes del contenedor.Por ejemplo, supongamos que tiene Form que contiene RectangleShape cuyo valor de propiedad de Anchor se establezca en Top y a Bottom.RectangleShape se ajusta para mantener la distancia entre los bordes inferior y superior de Form mientras Height de Form aumentará.

Notas para los herederos

Cuando se reemplaza la propiedad de Anchor en una clase derivada, utilice la propiedad de Anchor de la clase base para extender la implementación base.Si no, deberá proporcionarse toda la implementación.No es necesario reemplazar los descriptores de get y de set de la propiedad de Anchor ; puede reemplazar solo uno si necesita.

Ejemplos

El ejemplo siguiente se muestra cómo utilizar la propiedad de Anchor para cambiar el tamaño de las formas cuando se cambia el tamaño de un formulario.Este ejemplo requiere tener dos o más controles de la forma o de línea en un formulario.

Private Sub ResizeShapes()
    ' Loop through the ShapeCollection.
    For Each shape As PowerPacks.Shape In ShapeContainer1.Shapes
        ' Set the Anchor property.
        shape.Anchor = AnchorStyles.Bottom Or AnchorStyles.Left Or
          AnchorStyles.Right Or AnchorStyles.Top
    Next
End Sub

private void ResizeShapes()
{
    // Loop through the ShapeCollection.
    foreach (Shape shape in shapeContainer1.Shapes)
    {
        // Set the Anchor property.
        shape.Anchor = AnchorStyles.Bottom | AnchorStyles.Left | 
            AnchorStyles.Right | AnchorStyles.Top;
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.