ShapeCollection.Clear 方法

项目
09/04/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 方法从父容器中移除整个形状集合。此示例要求窗体上至少有两个 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();
}