[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
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 Function FindForm As Form
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.AllWindows)]
public Form FindForm()
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::AllWindows)]
public:
Form^ FindForm()
[<UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.AllWindows)>] member FindForm : unit -> Form
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 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
// 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; }
// 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.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0.NET Framework Client Profile
Supported in: 4, 3.5 SP1-
UIPermission
for all windows to call this method. Associated enumeration: AllWindows value of UIPermissionWindow.
Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.