Window.Owner Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Obtiene o establece el objeto Window que es la ventana propietaria de este objeto 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 la ventana propietaria de este objeto Window.

Excepciones

ArgumentException

Una ventana intenta ser propietaria de sí misma.

o bien

Dos ventanas intentan ser propietarias la una de la otra.

InvalidOperationException

La propiedad Owner está establecida en una ventana visible que se muestra mediante ShowDialog().

o bien

La propiedad Owner está establecida en 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 secundaria se abre mediante una ventana primaria llamando a ShowDialog, se establece una relación implícita entre la ventana primaria y secundaria. Esta relación aplica ciertos comportamientos, incluido con respecto a minimizar, maximizar y restaurar.

Cuando una ventana secundaria se crea mediante una ventana primaria 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; cualquier ventana puede cubrir el otro, o ser minimizado, maximizado y restaurado independientemente del otro.

Para permitirle 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 la ventana del propietario y sus ventanas propiedad.

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

• Las ventanas propiedad que no se han abierto mediante 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 Showpropietaria se abrió mediante , y 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 la ventana secundaria y la ventana primaria presionando el botón de la barra de tareas. En su lugar, al presionar el botón de la 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 mediante una llamada ShowDialog a para garantizar un comportamiento correcto con .

Nota

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

Consulte también

• OwnedWindows