ShapeCollection.Remove, méthode

Article
05/16/2015

Supprime le Shape spécifié de la ShapeCollection.

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

Syntaxe

'Déclaration
Public Sub Remove ( _
    value As Shape _
)

public void Remove(
    Shape value
)

public:
void Remove(
    Shape^ value
)

member Remove : 
        value:Shape -> unit

public function Remove(
    value : Shape
)

Paramètres

value
Type : Microsoft.VisualBasic.PowerPacks.Shape

Shape à supprimer de ShapeCollection.

Notes

Lorsque Shape est supprimé de la collection de contrôle, toutes les formes suivantes sont relevées une position dans la collection.

Vous pouvez également supprimer Shape à l'aide de la méthode de RemoveAt, ou supprimez toutes les formes à l'aide de la méthode de Clear.

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

Remarques à l'attention des héritiers

En remplaçant Remove dans une classe dérivée, veillez à appeler la méthode de Remove de la classe de base pour garantir que la forme est supprimée de la collection.

Exemples

L'exemple suivant montre comment utiliser la méthode de Remove pour supprimer Shape d'une forme s'il est membre d'ShapeCollectiondu formulaire. Cet exemple requiert que vous disposez d'au moins deux contrôles d'OvalShape sur un formulaire.

Private Sub Form1_Click() Handles Me.Click
    Dim canvas As ShapeContainer
    ' Get the ShapeContainer.
    canvas = OvalShape1.Parent
    ' If OvalShape2 is in the same collection, remove it. 
    If canvas.Shapes.Contains(OvalShape2) Then
        canvas.Shapes.Remove(OvalShape2)
    End If 
End Sub

private void form1_Click(object sender, System.EventArgs e)
{
    ShapeContainer canvas;
    // Get the ShapeContainer.
    canvas = ovalShape1.Parent;
    // If OvalShape2 is in the same collection, remove it. 
    if (canvas.Shapes.Contains(ovalShape2))
    {
        canvas.Shapes.Remove(ovalShape2);
    }
}

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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.