Shape.Anchor, propriété

Article
05/16/2015

Obtient ou définit les bords du conteneur auquel une forme est liée et détermine le redimensionnement d'une forme lorsque son parent est redimensionné.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
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)

Valeur de propriété

Type : AnchorStyles
Combinaison d'opérations de bits des valeurs AnchorStyles.La valeur par défaut est Top et Left.

Notes

Utilisez le Anchor propriété pour définir comment une forme est redimensionnée automatiquement lorsque son contrôle parent est redimensionné. Ancrage d'une forme à son contrôle parent garantit que les bords ancrés conservent la même position par rapport aux bords du contrôle parent lors du redimensionnement du contrôle parent.

Vous pouvez ancrer une forme à un ou plusieurs bords de son conteneur. Par exemple, supposons que vous disposez d'un Form contenant un RectangleShape dont Anchor propriété a la valeur Top et Bottom. Le RectangleShape est agrandi pour maintenir la distance entre les bords supérieur et inférieur de la Form comme le Height de la Form est augmentée.

Remarques à l'attention des héritiers

Lorsque vous substituez la Anchor propriété dans une classe dérivée, utilisez la classe de base Anchor propriété pour étendre l'implémentation de base. Sinon, vous devez fournir toute l'implémentation. Vous n'êtes pas obligé de substituer les deux le get et set accesseurs de le Anchor propriété ; Vous pouvez remplacer uniquement une si vous devez.

Exemples

L'exemple suivant montre comment utiliser le Anchor propriété pour redimensionner les formes lorsqu'un formulaire est redimensionné. Cet exemple suppose que vous disposez de deux ou plusieurs contrôles forme ou une ligne sur un formulaire.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.