Window.Owner Propriedade

Definição

Obtém ou define o Window que detém isto Window.

public:
 property System::Windows::Window ^ Owner { System::Windows::Window ^ get(); void set(System::Windows::Window ^ value); };
public System.Windows.Window Owner { [System.Security.SecurityCritical] get; [System.Security.SecurityCritical] set; }
public System.Windows.Window Owner { get; set; }
[<get: System.Security.SecurityCritical>]
[<set: System.Security.SecurityCritical>]
member this.Owner : System.Windows.Window with get, set
member this.Owner : System.Windows.Window with get, set
Public Property Owner As Window

Valor de Propriedade

Um Window objeto que representa o proprietário deste Window.

Atributos

Exceções

Uma janela tenta dominar-se a si própria

-ou-

Duas janelas tentam dominar uma à outra.

A Owner propriedade está definida numa janela visível mostrada usando ShowDialog()

-ou-

A Owner propriedade está equipada com uma janela que não tinha sido mostrada anteriormente.

Exemplos

O exemplo seguinte mostra como estabelecer a relação proprietário/propriedade.

// 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()

Observações

Quando uma janela filha é aberta por uma janela pai ao chamar ShowDialog, estabelece-se uma relação implícita entre a janela progenitor e a filha. Esta relação impõe certos comportamentos, incluindo no que diz respeito a minimizar, maximizar e restaurar.

Quando uma janela filho é criada por uma janela pai ao chamar Show, no entanto, a janela filha não tem relação com a janela mãe. Isto significa que:

  • A janela filho não tem referência à janela mãe.

  • O comportamento da janela filho não depende do comportamento da janela pai; qualquer janela pode cobrir a outra, ou ser minimizada, maximizada e restaurada independentemente da outra.

Permitir criar uma relação entre uma janela filho e uma janela parental apoia Window a noção de propriedade. A propriedade é estabelecida quando a Owner propriedade de uma janela (a janela possuída) é definida com uma referência a outra janela (a janela do proprietário).

Uma vez estabelecida esta relação, apresentam-se os seguintes comportamentos:

  • Se uma janela do proprietário for minimizada, todas as janelas próprias também são minimizadas.

  • Se uma janela de propriedade for minimizada, o seu proprietário não é minimizado.

  • Se uma janela do proprietário for maximizada, tanto a janela do proprietário como as janelas do proprietário são restauradas.

  • Uma janela do proprietário nunca pode cobrir uma janela própria.

  • Janelas próprias que não foram abertas não ShowDialog são modais. O utilizador ainda pode interagir com a janela do proprietário.

  • Se fechar uma janela do proprietário, as janelas de propriedade também estão fechadas.

  • Se uma janela de propriedade foi aberta pela janela do proprietário usando Show, e a janela do dono estiver fechada, o evento da Closing janela de propriedade não é elevado.

Quando abrir uma janela filho ao chamar ShowDialog, deve também definir a Owner propriedade da janela filha. Se não o fizeres, os teus utilizadores não conseguirão restaurar tanto a janela filho como a janela pai ao pressionar o botão da barra de tarefas. Em vez disso, ao pressionar o botão da barra de tarefas, aparece uma lista de janelas, incluindo a filha e a janela principal, para selecionarem; apenas a janela selecionada é restaurada.

Importante

Deve também definir a Owner propriedade numa janela que seja aberta ao chamar ShowDialog para garantir o comportamento correto com a janela de proprietário.

Note

Não pode definir ou obter esta propriedade quando uma janela está alojada num navegador.

Aplica-se a

Ver também