Shape.Parent (Propiedad)

Artículo
11/02/2012

Obtiene o establece el contenedor primario de una línea o forma.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
<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 propiedad

Tipo: Microsoft.VisualBasic.PowerPacks.ShapeContainer
ShapeContainer que representa el elemento primario o el contenedor del control.

Comentarios

LineShape, OvalShape, o el control de RectangleShape pueden contener sólo en un objeto de ShapeContainer , que actúa como un lienzo para los controles de líneas y formas.

Cuando se agrega una línea o una forma en un formulario o contenedor en tiempo de diseño, ShapeContainer se crea automáticamente si aún no existe.La propiedad de Parent de línea o forma se establece en ese ShapeContainer.La propiedad de Parent de ShapeContainer se establece en el formulario o un control contenedor en los que la línea o forma se agregó.

Cuando se crea una línea o una forma en tiempo de ejecución mediante el método de New , debe establecer la propiedad de Parent a ShapeContainer.Si ShapeContainer ya existe en el formulario o contenedor, debe establecer la propiedad de Parent a ese ShapeContainer.Si no existe ningún ShapeContainer , puede crear ShapeContainer utilizando el método de New y establecer su propiedad de Parent al formulario o el contenedor.

[!NOTA]

no cree más de un ShapeContainer para cada formulario o contenedor; ello puede presentar un comportamiento inesperado.Si agrega una línea de tiempo de diseño o un control de forma a un formulario o contenedor después de escribir código para crear uno mediante programación, se modifica ese código para utilizar ShapeContainer creado por el diseñador.

Ejemplos

Comprueba el siguiente ejemplo ShapeContainer existente y conjuntos que la propiedad de Parent de OvalShape controla creada en tiempo de ejecución mediante el método de New .

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;

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.