ShapeCollection.AddRange メソッド

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

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

構文

'宣言
Public Sub AddRange ( _
    shapes As Shape() _
)

public void AddRange(
    Shape[] shapes
)

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

member AddRange : 
        shapes:Shape[] -> unit

public function AddRange(
    shapes : Shape[]
)

パラメーター

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

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

解説

shapes の配列に含まれる Shape オブジェクトがコレクションの最後に追加されます。

このコレクションへの Shape オブジェクトのグループを追加するには AddRange のメソッドを使用できます。 これは Add のメソッドを使用してコレクションに手動で各 Shape を追加するよりも高速です。

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

継承時の注意

派生クラスの AddRange をオーバーライドする場合、基本クラスのメソッドを AddRange 図形がコレクションに追加されたことを確認するために呼び出して確認します。

例

次の例では、フォームの ShapeCollection に OvalShape のコントロールのグループが追加されます。 例では、フォームの RectangleShape のコントロールが必要です。

Private Sub RectangleShape1_Click() 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 });
}

.NET Framework セキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

ShapeCollection クラス

Microsoft.VisualBasic.PowerPacks 名前空間

その他の技術情報

ライン コントロールとシェイプ コントロールの概要 (Visual Studio)

方法 : LineShape コントロールを使用して線を描画する (Visual Studio)

方法 : OvalShape コントロールおよび RectangleShape コントロールを使用して図形を描画する (Visual Studio)