Propriedade Shape.Parent

Artigo
10/26/2012

Obtém ou define o contêiner pai de um controle de linha ou forma.

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

Sintaxe

'Declaração
<BrowsableAttribute(False)> _
Public Property Parent As ShapeContainer

[BrowsableAttribute(false)]
public ShapeContainer Parent { get; set; }

[BrowsableAttribute(false)]
public:
property ShapeContainer^ Parent {
    ShapeContainer^ get ();
    void set (ShapeContainer^ value);
}

[<BrowsableAttribute(false)>]
member Parent : ShapeContainer with get, set

function get Parent () : ShapeContainer
function set Parent (value : ShapeContainer)

Valor de propriedade

Tipo: Microsoft.VisualBasic.PowerPacks.ShapeContainer
A ShapeContainer que representa o pai ou o recipiente do controle.

Comentários

A LineShape, OvalShape, ou RectangleShape controle pode estar contido em um ShapeContainer o objeto, que atua como uma tela para controles de linha e forma.

Quando você adiciona uma linha ou forma a um formulário ou um contêiner em tempo de design, um ShapeContainer é criado automaticamente se ainda não existir.O Parent propriedade da linha ou forma é definida como que ShapeContainer.O Parent propriedade da ShapeContainer é definido para o controle de formulário ou recipiente ao qual foi adicionada a linha ou forma.

Quando você cria uma linha ou forma em tempo de execução usando o New método, você deve definir sua Parent propriedade para um ShapeContainer.Se um ShapeContainer já existe para o formulário ou recipiente, você deve definir o Parent propriedade para que ShapeContainer.Se nenhum ShapeContainer existir, você pode criar um ShapeContainer usando o New método e o conjunto de seus Parent propriedade para o formulário ou recipiente.

Observação
Não crie mais de um ShapeContainer para cada formulário ou recipiente. Isso pode apresentar um comportamento inesperado.Se você adicionar uma linha de tempo de design ou o controle de forma a um formulário ou recipiente depois de escrever código para criar um programaticamente, você deve modificar o código para usar o ShapeContainer criado pelo designer.

Exemplos

O exemplo a seguir verifica a existência de credenciais ShapeContainer e define o Parent propriedade de um OvalShape controle foi criado em tempo de execução usando o New método.

Dim NewOval As New OvalShape
Dim i As Integer
Dim found As Boolean
' Loop through the Controls collection.
For i = 0 To Me.Controls.Count - 1
    ' If a ShapeContainer is found, make it the parent.
    If TypeOf Controls.Item(i) Is ShapeContainer Then
        NewOval.Parent = Controls.Item(i)
        found = True
        Exit For
    End If
Next
' If no ShapeContainer is found, create one and set the parents.
If found = False Then
    Dim sc As New ShapeContainer
    sc.Parent = Me
    NewOval.Parent = sc
End If
NewOval.Size = New Size(200, 300)

OvalShape NewOval = new OvalShape();
int i;
bool found = false;
// Loop through the Controls collection.
for (i = 0; i < this.Controls.Count; i++)
{
    // If a ShapeContainer is found, make it the parent.
    if (this.Controls[i] is ShapeContainer)
    {
        NewOval.Parent = ((ShapeContainer)Controls[i]);
        found = true;
        break;
    }
}
// If no ShapeContainer is found, create one and set the parents.
if (found == false)
{
    ShapeContainer sc = new ShapeContainer();
    sc.Parent = this;
    NewOval.Parent = sc;
}
NewOval.Size = new Size(200, 300);
found = true;

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.