Shape.Anchor プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

図形がバインドされるコンテナの端を取得または設定し、親のサイズが変更されるときに図形のサイズがどのように変化するかを決定します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
Public Overridable Property Anchor As AnchorStyles
'使用
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)

プロパティ値

型 : System.Windows.Forms.AnchorStyles

AnchorStyles 値のビットごとの組み合わせ。既定値は Top および Left です。

解説

親コントロールのサイズ変更に合わせて図形のサイズを自動的に変更する方法を定義するには、Anchor プロパティを使用します。図形をその親コントロールに固定すると、親コントロールのサイズが変更されても、固定された端は親コントロールの端に対して相対的に同じ位置に保たれます。

図形は、コンテナの 1 つ以上の端に固定できます。たとえば、Anchor プロパティの値が Top および Bottom に設定されている RectangleShape が Form 内にあると仮定します。RectangleShape のサイズは、Form の Height が大きくなると、Form の上端から下端までを占める大きさに拡大されます。

継承元へのメモ :

派生クラスで Anchor プロパティをオーバーライドする場合は、基本クラスの Anchor プロパティを使用して、基本の実装を拡張します。それ以外の場合は、すべての実装を提供する必要があります。Anchor プロパティの get アクセサおよび set アクセサの両方をオーバーライドする必要はありません。必要に応じて 1 つのアクセサだけをオーバーライドできます。

例

Anchor プロパティを使用して、フォームのサイズ変更に合わせて図形のサイズが変更されるようにする方法を次の例に示します。この例では、2 つ以上のシェイプコントロールまたはラインコントロールがフォーム上にあることが必要です。

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