Metodo ShapeCollection.AddRange

Articolo
05/16/2015

Aggiunge una matrice di oggetti Shape all'oggetto 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[]

Matrice di oggetti Shape da aggiungere all'insieme.

Note

Gli oggetti di Shape contenuti nella matrice di shapes vengono aggiunti alla fine della raccolta.

È possibile utilizzare il metodo di AddRange per aggiungere rapidamente un gruppo di oggetti di Shape alla raccolta. Ciò è più veloce manualmente all'aggiunta di ogni Shape alla raccolta utilizzando il metodo di Add.

Per rimuovere Shape precedentemente aggiunto, utilizzare Remove, RemoveAt, oppure il metodo Clear.

Note per gli eredi

Nell'eseguire l'override di AddRange in una classe derivata, assicurarsi di chiamare il metodo di AddRange della classe base per garantire che le forme vengono aggiunti alla raccolta.

Esempi

Nell'esempio seguente viene aggiunto un gruppo di controlli di OvalShape a ShapeCollection di un form. L'esempio è richiesto un controllo di RectangleShape 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 altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.