Shape.Parent-Eigenschaft

Artikel
10/24/2012

Ruft den übergeordneten Container des Formsteuerelements Linien-oder fest.

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

Syntax

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

Eigenschaftswert

Typ: Microsoft.VisualBasic.PowerPacks.ShapeContainer
ShapeContainer , das das übergeordnete Element oder den Container des Steuerelements darstellt.

Hinweise

LineShape, OvalShapeoder RectangleShape-Steuerelement kann nur in einem ShapeContainer-Objekt enthalten sein, das als Canvas für Das Line- und das Shape-Steuerelement fungieren soll.

Wenn Sie eine Zeile oder eine Form aus einem Formular oder Container zur Entwurfszeit hinzufügen, wird ShapeContainer automatisch erstellt, sofern noch nicht vorhanden ist.Die Parent-Eigenschaft der Zeile oder im wird mit diesem ShapeContainerfestgelegt.Die Parent-Eigenschaft ShapeContainer wird dem Formular oder an das Containersteuerelement festgelegt, an die die Zeile bzw. die Form hinzugefügt wurden.

Wenn Sie eine Zeile oder eine Form zur Laufzeit erstellen, indem Sie die New-Methode verwenden, müssen Sie deren Parent-Eigenschaft auf ShapeContainerfestlegen.Wenn ShapeContainer bereits für das Formular oder Container vorhanden ist, sollten Sie die Parent-Eigenschaft auf dieses ShapeContainerfestlegen.Wenn kein ShapeContainer vorhanden ist, können Sie ShapeContainer , indem Sie die New-Methode erstellen, verwenden und ihre Parent-Eigenschaft auf das Formular oder Container festlegen.

Hinweis
Erstellen Sie höchstens ein ShapeContainer für jedes Formular oder Container. Hierdurch wird das möglicherweise zu unerwartetem Verhalten vor.Wenn Sie eine Entwurfszeitzeile oder ein Formsteuerelement einem Formular oder Container Schreiben von Code hinzufügen, nachdem ein programmgesteuert zu erstellen, ändern Sie Code, um ShapeContainer zu verwenden, das vom Designer erstellt wird.

Beispiele

Im folgenden Beispiel wird überprüft, ShapeContainer vorhandenes und Sätze, die die Parent-Eigenschaft von OvalShape steuern, die zur Laufzeit erstellt wurde, indem die New-Methode.

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;

.NET Framework-Sicherheit

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.