Export (0) Print
Expand All

ContainerControl.ParentForm Property

Gets the form that the container control is assigned to.

[Visual Basic]
Public ReadOnly Property ParentForm As Form
[C#]
public Form ParentForm {get;}
[C++]
public: __property Form* get_ParentForm();
[JScript]
public function get ParentForm() : Form;

Property Value

The Form that the container control is assigned to.

Example

[Visual Basic, C#, C++] In this example, you create two forms: Form1 and Form2. You set the IsMdiContainer property of Form1 to true and make it the MdiParent of Form2. Next you create a button, button1, on each form. When the button on the parent form is clicked, the event handler displays the child form. When the button on the child form is clicked, the event handler displays the Name property of its parent form. Use the following two code segments to overwrite button1 event handlers in both forms.

[Visual Basic] 
' The event handler on Form1.
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button1.Click
    ' Create an instance of Form2.
    Dim f2 As New Form1()
    ' Make this form the parent of f2.
    f2.MdiParent = Me
    ' Display the form.
    f2.Show()
End Sub 'button1_Click

[C#] 
// The event handler on Form1.
private void button1_Click(object sender, System.EventArgs e)
{
    // Create an instance of Form2.
    Form1 f2 = new Form1();
    // Make this form the parent of f2.
    f2.MdiParent = this;
    // Display the form.
    f2.Show();
}

[C++] 
private:
    // The event handler on Form1.
    void button1_Click(Object* /*sender*/, System::EventArgs* /*e*/) {
        // Create an instance of Form2.
        Form1* f2 = new Form1();
        // Make this form the parent of f2.
        f2->MdiParent = this;
        // Display the form.
        f2->Show();
    }

[Visual Basic] 
' The event handler on Form2.
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    ' Get the Name property of the parent.
    Dim s As String = ParentForm.Name
    ' Display the name in a message box.
    MessageBox.Show("My parent is " + s + ".")
End Sub 'button1_Click

[C#] 
// The event handler on Form2.
private void button1_Click(object sender, System.EventArgs e)
{
    // Get the Name property of the Parent.
    string s = ParentForm.Name;
    // Display the name in a message box.
    MessageBox.Show("My Parent is " + s + ".");
}

[C++] 
private:
    // The event handler on Form2.
    void button1_Click(Object* /*sender*/, System::EventArgs* /*e*/) {
        // Get the Name property of the Parent.
        String* s = ParentForm->Name;
        // Display the name in a message box.
        MessageBox::Show(String::Concat(S"My Parent is ", s, S"."));
    }

[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 Framework Security: 

See Also

ContainerControl Class | ContainerControl Members | System.Windows.Forms Namespace | Form

Show:
© 2014 Microsoft