ShapeCollection.Add メソッド

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

更新 : 2007 年 11 月

指定した Shape を ShapeCollection に追加します。

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

構文

'宣言
Public Sub Add ( _
    value As Shape _
)
'使用
Dim instance As ShapeCollection
Dim value As Shape

instance.Add(value)

public void Add(
    Shape value
)

public:
void Add(
    Shape^ value
)

public function Add(
    value : Shape
)

パラメータ

value
型 : Microsoft.VisualBasic.PowerPacks.Shape

ShapeCollection に追加する Shape です。

解説

Add メソッドを使用すると、Shape オブジェクトを ShapeCollection の最後に追加できます。

AddRange メソッドを使用して、新しい Shape オブジェクトをコレクションに追加することもできます。

前に追加した Shape を削除するには、Remove メソッド、RemoveAt メソッド、または Clear メソッドを使用します。

継承元へのメモ :

派生クラスで Add をオーバーライドする場合は、基本クラスの Add メソッドを呼び出して、Shape が確実に ShapeCollection に追加されるようにしてください。

例

新しい Shape をフォームの ShapeCollection に追加する例を次に示します。この例では、RectangleShape コントロールがフォーム上にあることが必要です。

Private Sub RectangleShape1_Click(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) Handles RectangleShape1.Click
    ' Declare a new oval shape to add to the form.
    Dim oval As OvalShape = New OvalShape()
    ' Add the oval shape to the form.
    RectangleShape1.Parent.Shapes.Add(oval)
    oval.Location = New Point(50, 50)
    oval.Size = New Size(200, 100)
End Sub

private void rectangleShape1_Click(System.Object sender, System.EventArgs e)
{
    // Declare a new oval shape to add to the form.
    OvalShape oval = new OvalShape();
    // Add the oval shape to the form.
    rectangleShape1.Parent.Shapes.Add(oval);
    oval.Location = new Point(50, 50);
    oval.Size = new Size(200, 100);
}