Propriedade ShapeContainer.Shapes

Artigo
10/26/2012

Obtém a coleção de formas que estão contidos no ShapeContainer.

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

Sintaxe

'Declaração
<BrowsableAttribute(False)> _
Public ReadOnly Property Shapes As ShapeCollection

[BrowsableAttribute(false)]
public ShapeCollection Shapes { get; }

[BrowsableAttribute(false)]
public:
property ShapeCollection^ Shapes {
    ShapeCollection^ get ();
}

[<BrowsableAttribute(false)>]
member Shapes : ShapeCollection

function get Shapes () : ShapeCollection

Valor de propriedade

Tipo: Microsoft.VisualBasic.PowerPacks.ShapeCollection
A ShapeCollection que representa a coleção de formas que estão contidos no ShapeContainer.

Comentários

A ShapeCollection atua como um pai a uma coleção de formas.Por exemplo, quando várias formas são adicionadas a um Form, cada forma é um membro do ShapeCollection atribuído ao ShapeContainer do formulário.

Você pode trabalhar com formas a ShapeCollection atribuído a uma ShapeContainer usando os métodos disponíveis na ShapeCollection classe.

Quando você adiciona várias formas para um ShapeContainer, é recomendável que você chama o SuspendLayout método antes de inicializar as formas a serem adicionados.Depois de adicionar as formas para a ShapeContainer, chame o ResumeLayout método.Usando SuspendLayout e ResumeLayout aumentará o desempenho de aplicativos que têm muitas formas.

Exemplos

O exemplo a seguir remove um Shape da ShapeCollection de um formulário (representado pela Shapes propriedade) se for um membro da coleção.Este exemplo requer que você tenha um LineShape, um OvalShapee um RectangleShape controle em um formulário.Quando uma forma é clicada, ele é removido do ShapeCollection a menos que ele seja a última forma na coleção.

Private Sub Shapes_Click(
    ByVal sender As System.Object, 
    ByVal e As System.EventArgs
  ) Handles RectangleShape1.Click, 
            OvalShape1.Click, LineShape1.Click

    ' Determine whether the shape is in the collection.
    If ShapeContainer1.Shapes.Contains(sender) Then
        ' If the index is greater than 0, remove the shape.
        If ShapeContainer1.Shapes.IndexOf(sender) > 0 Then
            ShapeContainer1.Shapes.Remove(sender)
        End If
    End If
End Sub

private void Shapes_Click(System.Object sender, System.EventArgs e)
{
    // Determine whether the shape is in the collection.
    if (shapeContainer1.Shapes.Contains((Shape) sender))
    // If the index is greater than 0, remove the shape.
    {
        if (shapeContainer1.Shapes.IndexOf((Shape)sender) > 0)
        {
            shapeContainer1.Shapes.Remove((Shape)sender);
        }
    }
}

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.