Propriedade Shape.Parent

Artigo
08/25/2010

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

<BrowsableAttribute(False)> _
Public Property Parent As ShapeContainer

Dim instance As Shape
Dim value As ShapeContainer

value = instance.Parent

instance.Parent = value

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

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

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

Valor de propriedade

Tipo: Microsoft.VisualBasic.PowerPacks.ShapeContainer
A ShapeContainer que representa o pai ou contêiner do controle.

Comentários

A LineShape, OvalShape, ou RectangleShape controle pode estar contido em apenas um ShapeContainer objeto, que atua sistema autônomo uma tela para controles de linha e forma.

Quando você adiciona uma linha ou forma a um formulário ou o contêiner em time de design, um ShapeContainer é criado automaticamente se já não existir. The Parent propriedade de linha ou forma é conjunto ao ShapeContainer. The Parent propriedade das ShapeContainer é conjunto ao controle de formulário ou contêiner ao qual a linha ou forma foi adicionada.

Quando você criar uma linha ou forma em time de execução usando o New método, você deve conjunto seu Parent propriedade para um ShapeContainer. If a ShapeContainer já existe para o formulário ou contêiner, você deve conjunto o Parent propriedade para que ShapeContainer. Se nenhum ShapeContainer existe, você pode criar um ShapeContainer usando o New método e conjunto seu Parent propriedade para o formulário ou contêiner.

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

Exemplos

O exemplo a seguir verifica um existenteShapeContainer e define o Parent propriedade de um OvalShape controle foi criado em time de execução usando o New método.

Dim NewOval AsNew OvalShape
Dim i AsIntegerDim found AsBoolean' Loop through the Controls collection.For i = 0 ToMe.Controls.Count - 1
    ' If a ShapeContainer is found, make it the parent.IfTypeOf Controls.Item(i) Is ShapeContainer Then
        NewOval.Parent = Controls.Item(i)
        found = TrueExitForEndIfNext' If no ShapeContainer is found, create one and set the parents.If found = FalseThenDim sc AsNew ShapeContainer
    sc.Parent = Me
    NewOval.Parent = sc
EndIf
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;

Permissões

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ódigos parcialmente Confiável.