Shape.Anchor, propriété

Article
11/15/2012

Obtient ou définit les bords du conteneur vers lequel une forme est liée, et détermine comment une forme est redimensionnée 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 : System.Windows.Forms.AnchorStyles
Combinaison d'opérations de bits des valeurs AnchorStyles.La valeur par défaut est Top et Left.

Notes

Utilisez la propriété d'Anchor pour définir comment une forme est automatiquement redimensionnée lorsque son contrôle parent est redimensionné.Ancrer une forme à son contrôle parent garantit que les bords ancrés restent dans la même position relative aux bords du contrôle de parent lorsque le contrôle de parent est redimensionné.

Vous pouvez ancrer une forme à un ou plusieurs bords de son conteneur.Par exemple, supposez que vous avez Form qui contient RectangleShape dont la valeur de propriété d'Anchor est définie à Top et à Bottom.RectangleShape est étiré pour maintenir la distance entre les bords de haut et bas d'Form comme Height d'Form est augmenté.

Remarques à l'attention des héritiers

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

Exemples

L'exemple suivant montre comment utiliser la propriété d'Anchor pour redimensionner des formes lorsqu'un formulaire est redimensionné.Cet exemple requiert que vous avez deux ou plusieurs des contrôles de forme ou de 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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.