Window.Owner Propriedade

  • Referência

Definição

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Obtém ou define o Window que possui esse 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 da propriedade

Window

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

Atributos
SecurityCriticalAttribute

Exceções

ArgumentException

Uma janela tenta se possuir

-ou-

Duas janelas tentam se possuir.

InvalidOperationException

A propriedade Owner é definida em uma janela visível mostrada usando ShowDialog()

-ou-

A propriedade Owner é definida com uma janela que não foi mostrada anteriormente.

Exemplos

O exemplo a seguir mostra como estabelecer a relação de 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()

Comentários

Quando uma janela filho é aberta por uma janela pai chamando ShowDialog, uma relação implícita é estabelecida entre a janela pai e filho. Essa relação impõe determinados comportamentos, inclusive no que diz respeito à minimização, maximização e restauração.

Quando uma janela filho é criada por uma janela pai chamando Show, no entanto, a janela filho não tem uma relação com a janela pai. Isso significa que:

  • A janela filho não tem uma referência à janela pai.

  • 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.

Para permitir que você crie uma relação entre uma janela filho e uma janela pai, Window dá suporte à noção de propriedade. A propriedade é estabelecida quando a propriedade Owner de uma janela (a janela de propriedade) é definida com uma referência a outra janela (a janela do proprietário).

Depois que essa relação é estabelecida, os seguintes comportamentos são exibidos:

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

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

  • Se uma janela do proprietário for maximizada, a janela do proprietário e suas próprias janelas serão restauradas.

  • Uma janela de proprietário nunca pode cobrir uma janela de propriedade.

  • Janelas de propriedade que não foram abertas usando ShowDialog não são modais. O usuário ainda pode interagir com a janela do proprietário.

  • Se você fechar uma janela de proprietário, suas próprias janelas também serão fechadas.

  • Se uma janela de propriedade tiver sido aberta pela janela do proprietário usando Showe a janela do proprietário estiver fechada, o evento Closing da janela de propriedade não será acionado.

Ao abrir uma janela filho chamando ShowDialog, você também deve definir a propriedade Owner da janela filho. Se você não fizer isso, os usuários não poderão restaurar a janela filho e a janela pai pressionando o botão da barra de tarefas. Em vez disso, pressionar o botão da barra de tarefas produzirá uma lista de janelas, incluindo a janela filho e pai, para que elas selecionem; somente a janela selecionada é restaurada.

Importante

Você também deve definir a propriedade Owner em uma janela aberta chamando ShowDialog para garantir o comportamento correto com a janela de propriedade.

Nota

Você não pode definir ou obter essa propriedade quando uma janela é hospedada em um navegador.

Aplica-se a

Confira também