Shape.Parent (Propiedad)
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.
Vea también
Referencia
Microsoft.VisualBasic.PowerPacks (Espacio de nombres)
Otros recursos
Cómo: Dibujar líneas con el control LineShape (Visual Studio)
Cómo: Dibujar formas con los controles OvalShape y RectangleShape (Visual Studio)
Introducción a los controles de líneas y formas (Visual Studio)