Window.Owner Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Obtiene o establece el Window que posee este Window.

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 al propietario de este Window.

Excepciones

ArgumentException

Una ventana intenta poseerse a sí misma

-o-

Dos ventanas intentan poseerse entre sí.

InvalidOperationException

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

-o-

La propiedad Owner 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 propiedad Owner 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 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 con Showy se cierra la ventana del propietario, no se genera el evento Closing de la ventana propiedad.

Al abrir una ventana secundaria llamando a ShowDialog, también debe establecer la propiedad Owner 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 propiedad Owner en una ventana que se abre llamando a ShowDialog 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