ShapeCollection.AddRange メソッド

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

更新 : 2007 年 11 月

ShapeCollection に Shape オブジェクトの配列を追加します。

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

構文

'宣言
Public Sub AddRange ( _
    shapes As Shape() _
)
'使用
Dim instance As ShapeCollection
Dim shapes As Shape()

instance.AddRange(shapes)

public void AddRange(
    Shape[] shapes
)

public:
void AddRange(
    array<Shape^>^ shapes
)

public function AddRange(
    shapes : Shape[]
)

パラメータ

shapes
型 : array<Microsoft.VisualBasic.PowerPacks.Shape[]

コレクションに追加する Shape オブジェクトの配列。

解説

shapes 配列に格納されている Shape オブジェクトが、コレクションの末尾に追加されます。

AddRange メソッドを使用すると、Shape オブジェクトのグループをコレクションにすばやく追加できます。この方法は、Add メソッドを使用して各 Shape をコレクションに手動で追加するより簡単な方法です。

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

継承元へのメモ :

派生クラスで AddRange をオーバーライドする場合は、基本クラスの AddRange メソッドを呼び出して、確実に図形がコレクションに追加されるようにしてください。

例

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

Private Sub RectangleShape1_Click(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) Handles RectangleShape1.Click
    ' Create two oval shapes to add to the form.
    Dim oval1 As OvalShape = New OvalShape()
    Dim oval2 As OvalShape = New OvalShape()

    ' Set the size of the ovals.
    oval1.Size = New Size(100, 200)
    oval2.Size = oval1.Size

    ' Set the appropriate location of ovals.
    oval1.Location = New Point(10, 10)
    oval2.Location = New Point(oval1.Left + 10, oval1.Top + 10)

    ' Add the controls to the form by using the AddRange method.
    RectangleShape1.Parent.Shapes.AddRange(New Shape() {oval1, oval2})
End Sub

private void rectangleShape1_Click(System.Object sender, System.EventArgs e)
{
    // Create two oval shapes to add to the form.
    OvalShape oval1 = new OvalShape();
    OvalShape oval2 = new OvalShape();

    // Set the size of the ovals.
    oval1.Size = new Size(100, 200);
    oval2.Size = oval1.Size;

    // Set the appropriate location of ovals.
    oval1.Location = new Point(10, 10);
    oval2.Location = new Point(oval1.Left + 10, oval1.Top + 10);

    // Add the controls to the form by using the AddRange method.
    rectangleShape1.Parent.Shapes.AddRange(new Shape[] { oval1, oval2 });
}