ShapeCollection.Clear, méthode

Article
11/15/2012

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

'Déclaration
Public Sub Clear

public void Clear()

public:
virtual void Clear() sealed

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

public final function Clear()

Implémentations

IList.Clear()

Notes

Vous pouvez utiliser la méthode d'Clear pour supprimer la collection entière de formes d'ShapeContainer.

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

Pour ajouter de nouveaux objets d'Shape à la collection, utilisez la méthode d'Add ou d'AddRange.

Remarques à l'attention des héritiers

En substituant Clear dans une classe dérivée, assurez -vous d'appeler la méthode d'Clear de classe de base pour vérifier que toutes les formes sont supprimées de la collection.

Exemples

L'exemple suivant montre comment utiliser la méthode d'Clear pour supprimer la collection entière de formes d'un conteneur parent.Cet exemple requiert que vous avez au moins deux contrôles d'OvalShape sur un formulaire.

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

Sécurité .NET Framework

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.