Shape.Parent-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft den übergeordneten Container eines Shape- oder Line-Steuerelements ab oder legt diesen fest.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

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

Eigenschaftenwert

Typ: Microsoft.VisualBasic.PowerPacks.ShapeContainer

ShapeContainer, der das übergeordnete Element oder den Container des Steuerelements darstellt.

Hinweise

Die Steuerelemente LineShape, OvalShape oder RectangleShape können nur in einem ShapeContainer-Objekt enthalten sein, welches als Canvas für Line- und Shape-Steuerelemente fungiert.

Wenn Sie zur Entwurfszeit eine Linie oder eine Form zu einem Formular oder Container hinzufügen, wird automatisch ein ShapeContainer-Objekt erstellt, wenn dieses nicht bereits vorhanden ist. Die Parent-Eigenschaft der Linie oder Form wird auf dieses ShapeContainer-Objekt festgelegt. Die Parent-Eigenschaft von ShapeContainer wird auf das Formular oder Containersteuerelement festgelegt, dem die Linie bzw. Form hinzugefügt wurde.

Wenn Sie zur Laufzeit eine Linie oder Form mit der New-Methode erstellen, müssen Sie die zugehörige Parent-Eigenschaft auf ShapeContainer festlegen. Falls für das Formular bzw. für den Container bereits ein ShapeContainer-Objekt vorhanden ist, müssen Sie die Parent-Eigenschaft auf dieses ShapeContainer-Objekt festlegen. Falls kein ShapeContainer vorhanden ist, können Sie ein ShapeContainer-Objekt mit der New-Methode erstellen und die Parent-Eigenschaft auf das Formular bzw. den Container festlegen.

Hinweis:
Erstellen Sie für jedes Formular bzw. jeden Container nur ein ShapeContainer-Objekt. Andernfalls kann es zu einem unerwarteten Verhalten kommen. Wenn Sie zur Entwurfszeit ein Line- oder Shape-Steuerelement zu einem Formular oder Container hinzufügen, nachdem Sie Code zum programmgesteuerten Erstellen eines solchen Steuerelements geschrieben haben, müssen Sie den Code so ändern, dass dieser das vom Entwickler erstellte ShapeContainer-Objekt verwendet.

Erstellen Sie für jedes Formular bzw. jeden Container nur ein ShapeContainer-Objekt. Andernfalls kann es zu einem unerwarteten Verhalten kommen. Wenn Sie zur Entwurfszeit ein Line- oder Shape-Steuerelement zu einem Formular oder Container hinzufügen, nachdem Sie Code zum programmgesteuerten Erstellen eines solchen Steuerelements geschrieben haben, müssen Sie den Code so ändern, dass dieser das vom Entwickler erstellte ShapeContainer-Objekt verwendet.

Beispiele

Im folgenden Beispiel wird überprüft, ob ein ShapeContainer-Objekt vorhanden ist. Weiterhin wird die Parent-Eigenschaft eines OvalShape-Steuerelements festgelegt, das zur Laufzeit mit der New-Methode erstellt wurde.

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;

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.