Shape.Parent (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

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

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

Sintaxis

<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 propiedad

Tipo: Microsoft.VisualBasic.PowerPacks.ShapeContainer

ShapeContainer que representa el control primario o el contenedor del control.

Comentarios

Únicamente puede haber un control LineShape, OvalShape o RectangleShape en un objeto ShapeContainer, que actúa como un lienzo para los controles de línea y de forma.

Al agregar una línea o una forma en tiempo de diseño a un formulario o contenedor, se crea automáticamente un ShapeContainer si no existía ya. La propiedad Parent de la línea o la forma se establece en ese ShapeContainer. La propiedad Parent de ShapeContainer se establece en el control de formulario o contenedor al que se agregó la línea o la forma.

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

Nota:
No cree más de un ShapeContainer para cada formulario o contenedor; si lo hiciera, podría presentar un comportamiento inesperado. Si agrega un control de línea o de forma en tiempo de diseño a un formulario o contenedor después de escribir el código para crearlo mediante programación, debe modificar ese código para que utilice el ShapeContainer creado por el diseñador.

Ejemplos

En el ejemplo siguiente se comprueba si hay un ShapeContainer existente y se establece la propiedad Parent de un control OvalShape creado en tiempo de ejecución mediante el método 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;

Permisos

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.