Export (0) Print
Expand All
Expand Minimize
2 out of 2 rated this helpful - Rate this topic

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 Language Filter 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: 

See Also

Control Class | Control Members | System.Windows.Forms Namespace | Controls | Control.ControlCollection

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.