Control.Parent Property
Gets or sets the parent container of the control.
[Visual Basic] Public Property Parent As Control [C#] public Control Parent {get; set;} [C++] public: __property Control* get_Parent(); public: __property void set_Parent(Control*); [JScript] public function get Parent() : Control; public function set Parent(Control);
Property Value
A Control object that represents the parent or container control of the control.
Remarks
Setting the Parent property value to a null reference (Nothing in Visual Basic) removes the control from the Control.ControlCollection of its current parent control.
Example
[Visual Basic] ' This example uses the Parent property and the Find method of Control to set ' properties on the parent control of a Button and its Form. The example assumes ' that a Button control named button1 is located within a GroupBox control. The ' example also assumes that the Click event of the Button control is connected to ' the event handling method defined in the example. Private Sub button1_Click(sender As Object, e As System.EventArgs) Handles button1.Click ' Get the control the Button control is located in. In this case a GroupBox. Dim control As Control = button1.Parent ' Set the text and backcolor of the parent control. control.Text = "My Groupbox" control.BackColor = Color.Blue ' Get the form that the Button control is contained within. Dim myForm As Form = button1.FindForm() ' Set the text and color of the form containing the Button. myForm.Text = "The Form of My Control" myForm.BackColor = Color.Red End Sub [C#] // This example uses the Parent property and the Find method of Control to set // properties on the parent control of a Button and its Form. The example assumes // that a Button control named button1 is located within a GroupBox control. The // example also assumes that the Click event of the Button control is connected to // the event handling method defined in the example. private void button1_Click(object sender, System.EventArgs e) { // Get the control the Button control is located in. In this case a GroupBox. Control control = button1.Parent; // Set the text and backcolor of the parent control. control.Text = "My Groupbox"; control.BackColor = Color.Blue; // Get the form that the Button control is contained within. Form myForm = button1.FindForm(); // Set the text and color of the form containing the Button. myForm.Text = "The Form of My Control"; myForm.BackColor = Color.Red; } [C++] // This example uses the Parent property and the Find method of Control to set // properties on the parent control of a Button and its Form. The example assumes // that a Button control named button1 is located within a GroupBox control. The // example also assumes that the Click event of the Button control is connected to // the event handling method defined in the example. private: void button1_Click(Object* /*sender*/, System::EventArgs* /*e*/) { // Get the control the Button control is located in. In this case a GroupBox. Control* control = button1->Parent; // Set the text and backcolor of the parent control. control->Text = S"My Groupbox"; control->BackColor = Color::Blue; // Get the form that the Button control is contained within. Form* myForm = button1->FindForm(); // Set the text and color of the form containing the Button. myForm->Text = S"The Form of My Control"; myForm->BackColor = Color::Red; }
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework
.NET Framework Security:
- UIPermission for all windows to get this property value. Associated enumeration: UIPermissionWindow.AllWindows
See Also
Control Class | Control Members | System.Windows.Forms Namespace | Controls | Control.ControlCollection