Método ShapeCollection.Add

Artigo
10/26/2012

Adiciona o especificado Shape para o ShapeCollection.

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

Sintaxe

'Declaração
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
)

Parâmetros

value
Tipo: Microsoft.VisualBasic.PowerPacks.Shape
The Shape to add to the ShapeCollection.

Comentários

O Add método permite que você adicione Shape objetos ao final de uma ShapeCollection.

Você também pode adicionar novas Shape objetos à coleção usando o AddRange método.

Para remover um Shape que você adicionou anteriormente, use o Remove, RemoveAt, ou Clear método.

Observações para herdeiros

Ao substituir Add em uma classe derivada, certifique-se de chamar o Add método da classe base para garantir que o Shape é adicionado para o ShapeCollection.

Exemplos

O exemplo a seguir adiciona um novo Shape para o ShapeCollection de um formulário.Este exemplo requer que você tenha um RectangleShape controle em um formulário.

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);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.