Shape.Anchor-Eigenschaft

Artikel
10/24/2012

Ruft ab oder legt die Ränder des Containers, an den gebunden ist, eine Form fest und bestimmt, wie die Größe einer Form geändert wird, wenn das übergeordnete Element geändert wird.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
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)

Eigenschaftswert

Typ: System.Windows.Forms.AnchorStyles
Eine bitweise Kombination der AnchorStyles-Werte.Der Standardwert ist Top und Left.

Hinweise

Verwenden Sie die Anchor-Eigenschaft, um zu definieren, wie eine Form automatisch angepasst wird, wenn das übergeordnete Steuerelement angepasst wird.Das Verankern einer Form zu seinem übergeordneten Steuerelement stellt sicher, dass die verankerten Rand an der gleichen Position relativ zu den Rändern des übergeordneten Steuerelements bleiben, wenn das übergeordnete Steuerelement angepasst wird.

Sie können eine Form mit einem oder mehreren Rand des zugehörigen Containers verankert werden.Angenommen, Sie verfügen Form , das RectangleShape enthält, dessen Anchor-Eigenschaftswert auf Top und Bottomfestgelegt ist.RectangleShape wird gestreckt, um die Entfernung zwischen dem oberen und dem unteren Rand Form beizubehalten, während Height Form vergrößert wird.

Hinweise zur Vererbung

Wenn Sie die Anchor-Eigenschaft in einer abgeleiteten Klasse überschreiben, verwenden Sie die Anchor-Eigenschaft der Basisklasse, um die Basisimplementierung zu erweitern.Andernfalls müssen Sie die gesamte Implementierung bereitstellen.Es ist nicht erforderlich, die get und set Accessoren der Anchor-Eigenschaft zu überschreiben. Sie können nur ein überschreiben, wenn Sie benötigen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Anchor-Eigenschaft verwendet wird, um Formen zu ändern, wenn ein Größe des Formulars geändert wird.Dieses Beispiel setzt voraus, dass Sie zwei oder mehr Forms- oder Zeilen Steuerelemente in einem Formular.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.