ShapeCollection.Clear, méthode

Mise à jour : novembre 2007

Supprime toutes les formes de la collection.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

Public Sub Clear

Dim instance As ShapeCollection

instance.Clear()

public void Clear()

public:
virtual void Clear() sealed

public final function Clear()

Implémentations

IList.Clear()

Notes

Vous pouvez utiliser la méthode Clear pour supprimer l'ensemble de la collection de formes d'un ShapeContainer.

Pour supprimer une forme individuelle de la collection, utilisez la méthode Remove ou RemoveAt.

Pour ajouter de nouveaux objets Shape à la collection, utilisez les méthodes Add ou AddRange.

Remarques à l'attention des héritiers :

Lors de la substitution de Clear dans une classe dérivée, veillez à appeler la méthode Clear de la classe de base de manière à vous assurer que toutes les formes sont supprimées de la collection.

Exemples

L'exemple de code suivant montre comment utiliser la méthode Clear pour supprimer l'ensemble de la collection de formes d'un conteneur parent. Cet exemple suppose qu'il existe au moins deux contrôles OvalShape sur un formulaire.

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

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.