Metodo ShapeCollection.AddRange

Articolo
10/30/2012

aggiunge una matrice di Shape oggetti a ShapeCollection.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

'Dichiarazione
Public Sub AddRange ( _
    shapes As Shape() _
)

public void AddRange(
    Shape[] shapes
)

public:
void AddRange(
    array<Shape^>^ shapes
)

member AddRange : 
        shapes:Shape[] -> unit

public function AddRange(
    shapes : Shape[]
)

Parametri

shapes
Tipo: array<Microsoft.VisualBasic.PowerPacks.Shape[]
una matrice di Shape oggetti da aggiungere alla raccolta.

Note

Shape oggetti contenuti in shapes la matrice viene aggiunto alla fine della raccolta.

È possibile utilizzare AddRange metodo per aggiungere rapidamente un gruppo di Shape oggetti alla raccolta.È più veloce manualmente dell'aggiunta di ogni Shape alla raccolta tramite Add metodo.

Per rimuovere a Shape precedentemente aggiunto, utilizzare Remove, RemoveAt, o Clear metodo.

Note per gli eredi

Quando si sottopone a override AddRange in una classe derivata, assicurarsi di chiamare AddRange metodo della classe base per garantire che le forme vengono aggiunti alla raccolta.

Esempi

Nell'esempio seguente viene aggiunto un gruppo di OvalShape controlli a ShapeCollection di un form.Si presuppone che l'utente abbia a RectangleShape controllare in un form.

Private Sub RectangleShape1_Click() Handles RectangleShape1.Click
    ' Create two oval shapes to add to the form.
    Dim oval1 As OvalShape = New OvalShape()
    Dim oval2 As OvalShape = New OvalShape()

    ' Set the size of the ovals.
    oval1.Size = New Size(100, 200)
    oval2.Size = oval1.Size

    ' Set the appropriate location of ovals.
    oval1.Location = New Point(10, 10)
    oval2.Location = New Point(oval1.Left + 10, oval1.Top + 10)

    ' Add the controls to the form by using the AddRange method.
    RectangleShape1.Parent.Shapes.AddRange(New Shape() {oval1, oval2})
End Sub

private void rectangleShape1_Click(System.Object sender, System.EventArgs e)
{
    // Create two oval shapes to add to the form.
    OvalShape oval1 = new OvalShape();
    OvalShape oval2 = new OvalShape();

    // Set the size of the ovals.
    oval1.Size = new Size(100, 200);
    oval2.Size = oval1.Size;

    // Set the appropriate location of ovals.
    oval1.Location = new Point(10, 10);
    oval2.Location = new Point(oval1.Left + 10, oval1.Top + 10);

    // Add the controls to the form by using the AddRange method.
    rectangleShape1.Parent.Shapes.AddRange(new Shape[] { oval1, oval2 });
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.