Shape.Anchor (Propiedad)

Artículo
05/17/2015

Obtiene o establece los bordes del contenedor al que está enlazado una forma y determina cómo cambia el tamaño de una forma cuando cambia el 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: AnchorStyles
Combinación bit a bit de los valores de AnchorStyles.Los valores predeterminados son Top y Left.

Comentarios

Utilice la Anchor para definir cómo se cambia automáticamente el tamaño de una forma cuando se cambia el tamaño de su control primario. Delimitación de una forma a su control primario garantiza que los bordes acoplados permanezcan en la misma posición en relación con los bordes del control primario cuando se cambia el tamaño del control principal.

Puede anclar una forma a uno o más bordes de su contenedor. Por ejemplo, suponga que tiene un Form que contiene un RectangleShape cuya Anchor valor de la propiedad se establece en Top y Bottom. El RectangleShape se expande para mantener la distancia entre los bordes superior e inferior de la Form como el Height de la Form aumenta.

Notas para los herederos

Cuando se reemplaza el Anchor propiedad en una clase derivada, utilice la clase base Anchor propiedad para extender la implementación base. De lo contrario, debe proporcionar toda la implementación. No es necesario reemplazar ambos el get y set descriptores de acceso de la Anchor propiedad; puede reemplazar sólo uno, si necesita.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el Anchor propiedad para cambiar el tamaño de las formas cuando se cambia el tamaño de un formulario. Este ejemplo requiere que haya dos o más controles de forma o 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.