ShapeCollection.Clear 方法

项目
10/25/2012

从集合中移除所有形状。

命名空间： Microsoft.VisualBasic.PowerPacks
程序集： Microsoft.VisualBasic.PowerPacks.Vs（在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中）

语法

声明
Public Sub Clear

public void Clear()

public:
virtual void Clear() sealed

abstract Clear : unit -> unit 
override Clear : unit -> unit

public final function Clear()

实现

IList.Clear()

备注

可以使用 Clear 方法从 ShapeContainer移除形状的整个集合。

若要从集合移除单个形状，请使用 Remove 或 RemoveAt 方法。

若要向集合中添加新的 Shape 对象，请使用 Add 或 AddRange 方法。

对继承者的说明

当重写在派生类中 Clear ，请务必调用基类的 Clear 方法确保所有形状从集合中移除。

示例

下面的示例演示如何使用 Clear 方法从父容器中移除形状的整个集合。此示例要求窗体的至少有两个 OvalShape 控件。

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