Shape.Parent 屬性

發行項
08/21/2008

更新：2007 年 11 月

取得或設定 Line 或 Shape 控制項的父容器。

命名空間： Microsoft.VisualBasic.PowerPacks
組件： Microsoft.VisualBasic.PowerPacks.Vs (在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

語法

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

屬性值

型別：Microsoft.VisualBasic.PowerPacks.ShapeContainer

ShapeContainer，表示控制項的父代或容器。

備註

LineShape、OvalShape 或 RectangleShape 控制項只能包含在做為 Line 或 Shape 控制項畫布的 ShapeContainer 物件中。

當您在設計階段將線條或形狀加入至表單或容器時，如果 ShapeContainer 不存在，就會自動加以建立。線條或形狀的 Parent 屬性會設定為該 ShapeContainer，而 ShapeContainer 的 Parent 屬性會設定為線條或形狀加入所在的表單或容器控制項。

當您在執行階段使用 New 方法建立線條或形狀時，必須將其 Parent 屬性設定為 ShapeContainer。如果表單或容器的 ShapeContainer 已經存在，您應該將 Parent 屬性設定為該 ShapeContainer。如果 ShapeContainer 不存在，您可以使用 New 方法建立 ShapeContainer，並將其 Parent 屬性設定為表單或容器。

注意事項：
不要為每個表單或容器建立一個以上的 ShapeContainer，因為這樣做可能會造成未預期的行為。在撰寫以程式設計方式建立表單或容器的程式碼之後，如果您要加入設計階段 Line 或 Shape 控制項，則應修改該程式碼，以使用設計工具建立的 ShapeContainer。

範例

下列範例會檢查是否存在現有的 ShapeContainer，並為使用 New 方法在執行階段所建立的 OvalShape 控制項，設定其 Parent 屬性。

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;