Shape.Parent-Eigenschaft

Artikel
05/16/2015

Ruft den übergeordneten Container eines Line- oder Shape-Steuerelements ab oder legt diesen 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
Ein ShapeContainer , die die übergeordneten Knoten oder Container des Steuerelements darstellt.

Hinweise

Ein LineShape, OvalShape, oder RectangleShape Steuerelement kann nur in enthalten ein ShapeContainer -Objekt, das als eine Leinwand für Linien-und Formensteuerelemente fungiert.

Wenn Sie eine Linie oder Form zu einem Formular oder Container zur Entwurfszeit Hinzufügen einer ShapeContainer wird automatisch erstellt, wenn noch nicht vorhanden ist. Die Parent -Eigenschaft der Linie oder Form wird festgelegt, mit dem ShapeContainer. Die Parent Eigenschaft von der ShapeContainer festgelegt ist, in der Formular- oder Container, der die Linie oder Form hinzugefügt wurde.

Beim Erstellen einer Linie oder Form zur Laufzeit mithilfe der New -Methode, Sie müssen festlegen, seine Parent -Eigenschaft auf eine ShapeContainer. Wenn ein ShapeContainer bereits für das Formular oder den Container, sollten Sie festlegen der Parent Eigenschaft mit ShapeContainer. Wenn keine ShapeContainer vorhanden ist, können Sie eine ShapeContainer mithilfe der New -Methode und legen seine Parent -Eigenschaft auf das Formular oder den Container.

Hinweis

Erstellen Sie nicht mehr als eine ShapeContainer für jedes Formular oder Container; Dadurch kann zu unerwartetes Verhalten führen.Wenn Sie ein Entwurfszeit-Linie oder Formsteuerelement zu einem Formular oder Container nach dem Hinzufügen das Schreiben von Code, um eine programmgesteuert zu erstellen, sollten Sie diesen Code verwenden ändern die ShapeContainer vom Designer erstellt wurden.

Beispiele

Im folgenden Beispiel wird überprüft, für ein vorhandenes ShapeContainer und legt die Parent Eigenschaft ein OvalShape Steuerelement, das zur Laufzeit erstellt wurde der 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.