Control::Parent Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the parent container of the control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
[BrowsableAttribute(false)]
property Control^ Parent {
	Control^ get();
	void set(Control^ value);
}

Property Value

Type: System.Windows.Forms::Control^

A Control that represents the parent or container control of the control.

Setting the Parent property value to null removes the control from the Control::ControlCollection of its current parent control.

The following code example uses the Parent property and the FindForm method to set properties on the parent control of a button and its form.

   // 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 handler 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;
   }

UIPermission

for all windows to get this property value. Associated enumeration: UIPermissionWindow::AllWindows

.NET Framework
Available since 1.1
Return to top
Show: