Método ShapeCollection.Remove

Artigo
10/26/2012

Remove o especificado Shape partir do ShapeCollection.

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

Sintaxe

'Declaração
Public Sub Remove ( _
    value As Shape _
)

public void Remove(
    Shape value
)

public:
void Remove(
    Shape^ value
)

member Remove : 
        value:Shape -> unit

public function Remove(
    value : Shape
)

Parâmetros

value
Tipo: Microsoft.VisualBasic.PowerPacks.Shape
O Shape para remover o ShapeCollection.

Comentários

Quando um Shape é removido da coleção de controle, todas as formas subseqüentes são movidas para cima uma posição na coleção.

Você também pode remover um Shape usando o RemoveAt método ou remover todas as formas usando o Clear método.

Para adicionar novos Shape objetos à coleção, use o Add ou AddRange método.

Observações para herdeiros

Ao substituir Remove em uma classe derivada, certifique-se de chamar o Remove método da classe base para garantir que a forma é removida da coleção.

Exemplos

O exemplo a seguir demonstra como usar o Remove método para remover um Shape de um formulário se ele fizer parte do formulário ShapeCollection.Este exemplo requer que você tenha pelo menos duas OvalShape controles em um formulário.

Private Sub Form1_Click() Handles Me.Click
    Dim canvas As ShapeContainer
    ' Get the ShapeContainer.
    canvas = OvalShape1.Parent
    ' If OvalShape2 is in the same collection, remove it.
    If canvas.Shapes.Contains(OvalShape2) Then
        canvas.Shapes.Remove(OvalShape2)
    End If
End Sub

private void form1_Click(object sender, System.EventArgs e)
{
    ShapeContainer canvas;
    // Get the ShapeContainer.
    canvas = ovalShape1.Parent;
    // If OvalShape2 is in the same collection, remove it.
    if (canvas.Shapes.Contains(ovalShape2))
    {
        canvas.Shapes.Remove(ovalShape2);
    }
}

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.