System.Windows.Forms.Form.AddOwnedForm Method

Adds an owned form to this form.

Syntax

public void AddOwnedForm (Form ownedForm)

Parameters

ownedForm
The System.Windows.Forms.Form that this form will own.

Remarks

The form assigned to the owner form remains owned until the Form.RemoveOwnedForm(Form) method is called. You can also make a form owned by another by setting the Form.Owner property with a reference to its owner form.

When a form is owned by another form, it is closed or hidden with the owner form. For example, consider a form named Form2 that is owned by a form named Form1. If Form1 is closed or minimized, Form2 is also closed or hidden. Owned forms are also never displayed behind their owner form. You can use owned forms for windows such as find and replace windows, which should not be displayed behind the owner form when the owner form is selected.

Note:

If the form is a multiple-document interface (MDI) parent form, this property returns all forms that are displayed with the exception of any MDI child forms that are currently open. To obtain the MDI child forms opened in an MDI parent form, use the Form.MdiChildren property.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0