ShapeCollection.Clear メソッド

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

更新 : 2007 年 11 月

コレクションからすべての図形を削除します。

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

構文

'宣言
Public Sub Clear
'使用
Dim instance As ShapeCollection

instance.Clear()

public void Clear()

public:
virtual void Clear() sealed

public final function Clear()

実装

IList.Clear()

解説

Clear メソッドを使用すると、ShapeContainer から図形のコレクション全体を削除できます。

コレクションから図形を個別に削除するには、Remove メソッドまたは RemoveAt メソッドを使用します。

新しい Shape オブジェクトをコレクションに追加するには、Add メソッドまたは AddRange メソッドを使用します。

継承元へのメモ :

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

例

Clear メソッドを使用して親コンテナから図形のコレクション全体を削除する例を次に示します。この例では、少なくとも 2 つの OvalShape コントロールがフォーム上にあることが必要です。

  Private Sub Form1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Me.Click
      ' Call the method to remove the shapes.
      RemoveShapes(OvalShape1)
  End Sub

  Private Sub RemoveShapes(ByVal shape As Shape)
      Dim canvas As ShapeContainer

      ' Find the ShapeContainer in which the shape is located.
      canvas = shape.Parent
      ' Call the Clear method to remove all shapes.
      canvas.Shapes.Clear()
  End Sub

private void form1_Click(object sender, System.EventArgs e)
{
    // Call the method to remove the shapes.
    RemoveShapes(ovalShape1);
}

private void RemoveShapes(Shape shape)
{
    ShapeContainer canvas;

    // Find the ShapeContainer in which the shape is located.
    canvas = shape.Parent;
    // Call the Clear method to remove all shapes.
    canvas.Shapes.Clear();
}