Form.Owner Property (System.Windows.Forms)

Owner Property

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Form..::.Owner Property

Gets or sets the form that owns this form.

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

Syntax

Visual Basic (Declaration)

<BrowsableAttribute(False)> _
Public Property Owner As Form

Visual Basic (Usage)

Dim instance As Form
Dim value As Form

value = instance.Owner

instance.Owner = value

[BrowsableAttribute(false)]
public Form Owner { get; set; }

Visual C++

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

JScript

public function get Owner () : Form
public function set Owner (value : Form)

Property Value

Type: System.Windows.Forms..::.Form
A Form that represents the form that is the owner of this form.

Exceptions

Exception	Condition
Exception	A top-level window cannot have an owner.

Remarks

To make a form owned by another form, assign its Owner property a reference to the form that will be the owner.

When a form is owned by another form, it is minimized and closed with the owner form. For example, if Form2 is owned by form Form1, if Form1 is closed or minimized, Form2 is also closed or minimized. 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 disappear when the owner form is selected. To determine the forms that are owned by a parent form, use the OwnedForms property.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0

Reference

Form Class

Form Members

System.Windows.Forms Namespace

AddOwnedForm

RemoveOwnedForm

OwnedForms