ShapeCollection.Add-Methode

Artikel
05/16/2015

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 ermöglicht es Ihnen, Shape-Objekten zum Ende von ShapeCollection hinzuzufügen.

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

Um Shape entfernen, dem zuvor hinzugefügten, Remove, RemoveAt oder Clear-Methode verwenden.

Hinweise zur Vererbung

Wenn Sie Add in einer abgeleiteten Klasse überschreiben, stellen Sie sicher, die Add-Methode der Basisklasse aufrufen, um sicherzustellen, dass Shape der ShapeCollection hinzugefügt wird.

Beispiele

Im folgenden Beispiel wird eine neue Shape ShapeCollection eines Formulars hinzu. Dieses Beispiel erfordert, dass sich ein RectangleShape-Steuerelement auf einem Formular befindet.

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.