Shape.Anchor-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft die Ränder des Containers ab, an den eine Form gebunden ist, oder legt diese fest, und bestimmt, wie die Größe einer Form bei einer Größenänderung des übergeordneten Elements 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
'Usage
Dim instance As Shape
Dim value As AnchorStyles

value = instance.Anchor

instance.Anchor = value

public virtual AnchorStyles Anchor { get; set; }

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

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

Eigenschaftenwert

Typ: System.Windows.Forms.AnchorStyles

Eine bitweise Kombination der AnchorStyles-Werte. Die Standardeinstellungen sind Top und Left.

Hinweise

Definieren Sie mit der Anchor-Eigenschaft, wie die Größe einer Form automatisch geändert wird, sobald die Größe des übergeordneten Elements geändert wird. Das Verankern einer Form mit dem übergeordneten Steuerelement stellt sicher, dass bei einer Größenänderung des übergeordneten Steuerelements die verankerten Ränder relativ zu den Rändern des übergeordneten Steuerelements in derselben Position bleiben.

Eine Form kann an einem oder mehreren Rändern des Containers verankert werden. Angenommen Sie verfügen über ein Form mit RectangleShape, und die Anchor-Eigenschaft ist auf Top und Bottom festgelegt. RectangleShape wird gestreckt, um den Abstand zwischen dem oberen und unterem Rand von Form beizubehalten, wenn Sie Height von Form erhöhen.

Hinweise zur Vererbung:

Wenn Sie die Anchor-Eigenschaft in einer abgeleiteten Klasse überschreiben, müssen Sie die Anchor-Eigenschaft der Basisklasse verwenden, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl den get-Accessor als auch den set-Accessor der Anchor-Eigenschaft überschreiben. Sie können ggf. auch nur einen Accessor überschreiben.

Beispiele

Im folgenden Beispiel wird gezeigt, wie mit der Anchor-Eigenschaft die Größe von Formen angepasst wird, wenn Sie die Größe eines Formulars ändern. Für dieses Beispiel müssen auf einem Formular zwei oder mehr Shape- oder Line-Steuerelemente vorhanden sein.

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

Berechtigungen

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.