Propriedade Shape.Parent

Artigo
05/17/2015

Obtém ou define o contêiner pai de um controle de linha ou de 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
Um ShapeContainer que representa o pai ou o contêiner do controle.

Comentários

A LineShape, OvalShape, ou RectangleShape controle pode estar contido em um ShapeContainer objeto, que atua como um canvas pelos 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 para que ShapeContainer. O Parent propriedade o ShapeContainer é definido como o controle de formulário ou recipiente ao qual a linha ou forma foi adicionada.

Quando você cria uma linha ou forma no tempo de execução usando o New método, você deve definir seu Parent propriedade para um ShapeContainer. Se um ShapeContainer já existe para o formulário ou contêiner, você deve definir o Parent propriedade com a ShapeContainer. Se nenhum ShapeContainer existir, você pode criar um ShapeContainer usando o New método e defina seu Parent propriedade para o formulário ou contêiner.

Dica

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

Exemplos

O exemplo a seguir verifica a existência de credenciais ShapeContainer e define o Parent propriedade de um OvalShape controle que foi criado no 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ável.