Expand Minimize

Control::FindForm Method

Retrieves the form that the control is on.

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

[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::AllWindows)]
public:
Form^ FindForm()

Return Value

Type: System.Windows.Forms::Form
The Form that the control is on.

The control's Parent property value might not be the same as the Form returned by FindForm method. For example, if a RadioButton control is contained within a GroupBox control, and the GroupBox is on a Form, the RadioButton control's Parent is the GroupBox and the GroupBox control's Parent is the Form.

The following code example finds the form that contains the specified button.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft