Window.Owner Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Obtiene o establece el Window objeto que posee este Windowobjeto .

public:
 property System::Windows::Window ^ Owner { System::Windows::Window ^ get(); void set(System::Windows::Window ^ value); };

public System.Windows.Window Owner { get; set; }

member this.Owner : System.Windows.Window with get, set

Public Property Owner As Window

Valor de propiedad

Window

Objeto Window que representa el propietario de este Windowobjeto .

Excepciones

ArgumentException

Una ventana intenta poseerse a sí misma

-o-

Dos ventanas intentan poseerse entre sí.

InvalidOperationException

La Owner propiedad se establece en una ventana visible que se muestra mediante ShowDialog()

-o-

La Owner propiedad se establece con una ventana que no se ha mostrado anteriormente.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la relación de propietario o propiedad.

// Create a window and make this window its owner
Window ownedWindow = new Window();
ownedWindow.Owner = this;
ownedWindow.Show();

' Create a window and make this window its owner
Dim ownedWindow As New Window()
ownedWindow.Owner = Me
ownedWindow.Show()

Comentarios

Cuando una ventana primaria abre una ventana secundaria llamando a ShowDialog, se establece una relación implícita entre la ventana primaria y secundaria. Esta relación aplica ciertos comportamientos, incluidos con respecto a minimizar, maximizar y restaurar.

Sin embargo, cuando una ventana primaria crea una ventana secundaria llamando a Show, sin embargo, la ventana secundaria no tiene una relación con la ventana primaria. Esto significa que:

• La ventana secundaria no tiene una referencia a la ventana primaria.

• El comportamiento de la ventana secundaria no depende del comportamiento de la ventana primaria; cualquiera de las ventanas puede cubrir el otro, o bien minimizarse, maximizarse y restaurarse independientemente del otro.

Para permitir crear una relación entre una ventana secundaria y una ventana primaria, Window admite la noción de propiedad. La propiedad se establece cuando la Owner propiedad de una ventana (la ventana propiedad) se establece con una referencia a otra ventana (la ventana del propietario).

Una vez establecida esta relación, se muestran los siguientes comportamientos:

• Si se minimiza una ventana de propietario, también se minimizan todas sus ventanas propiedad.

• Si se minimiza una ventana propiedad, su propietario no se minimiza.

• Si se maximiza una ventana de propietario, se restauran tanto la ventana de propietario como sus ventanas propiedad.

• Una ventana de propietario nunca puede cubrir una ventana propiedad.

• Las ventanas propiedad que no se abrieron con ShowDialog no son modales. El usuario todavía puede interactuar con la ventana del propietario.

• Si cierra una ventana de propietario, también se cierran sus ventanas propiedad.

• Si su ventana de propietario abrió una ventana propiedad mediante Showy se cierra la ventana del propietario, no se genera el evento de Closing la ventana propiedad.

Al abrir una ventana secundaria llamando a ShowDialog, también debe establecer la Owner propiedad de la ventana secundaria. Si no lo hace, los usuarios no podrán restaurar tanto la ventana secundaria como la ventana primaria presionando el botón de la barra de tareas. En su lugar, al presionar el botón de barra de tareas se producirá una lista de ventanas, incluidas las ventanas secundarias y primarias, para que se seleccionen; solo se restaura la ventana seleccionada.

Importante

También debe establecer la Owner propiedad en una ventana que se abre llamando ShowDialog a para garantizar un comportamiento correcto con la ventana propiedad.

Nota

No se puede establecer ni obtener esta propiedad cuando se hospeda una ventana en un explorador.

Consulte también

• OwnedWindows