ShapeCollection.Add-Methode

Fügt dem ShapeCollection die angegebene Shape hinzu.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
Public Sub Add ( _
    value As Shape _
)

public void Add(
    Shape value
)

public:
void Add(
    Shape^ value
)

member Add : 
        value:Shape -> unit

public function Add(
    value : Shape
)

Parameter

value
Typ: Microsoft.VisualBasic.PowerPacks.Shape
Das Shape, das in ShapeCollection eingefügt werden soll.

Hinweise

Die Add-Methode können Sie Shape-Objekte am Ende der ShapeCollectionhinzuzufügen.

Sie können der Auflistung auch unter Verwendung der AddRange-Methode neue Shape-Objekte hinzufügen.

So entfernen Shape , den Sie vorher hinzugefügt haben, Remove, RemoveAtoder Clear-Methode verwenden.

Hinweise zur Vererbung

Wenn Sie Add in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die Add-Methode der Basisklasse aufrufen, um sicherzustellen, dass Shape zu ShapeCollectionhinzugefügt wird.

Beispiele

Im folgenden Beispiel wird eine neue Shape ShapeCollection eines Formulars hinzu.Dieses Beispiel setzt voraus, dass Sie ein RectangleShape-Steuerelement in einem Formular verfügen.

Private Sub RectangleShape1_Click() Handles RectangleShape1.Click
    ' Declare a new oval shape to add to the form.
    Dim oval As OvalShape = New OvalShape()
    ' Add the oval shape to the form.
    RectangleShape1.Parent.Shapes.Add(oval)
    oval.Location = New Point(50, 50)
    oval.Size = New Size(200, 100)
End Sub

private void rectangleShape1_Click(System.Object sender, System.EventArgs e)
{
    // Declare a new oval shape to add to the form.
    OvalShape oval = new OvalShape();
    // Add the oval shape to the form.
    rectangleShape1.Parent.Shapes.Add(oval);
    oval.Location = new Point(50, 50);
    oval.Size = new Size(200, 100);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.