Window.Owner Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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

Window

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

Exceções

ArgumentException

Uma janela tenta pertencer a si mesma

- ou -

Duas janelas tentam pertencer uma a outra.

InvalidOperationException

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

- ou -

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

Exemplos

O exemplo a seguir 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()

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 Owner propriedade 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 de 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 de 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 própria.

• 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 janelas de propriedade 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 for fechada, o evento da janela de Closing propriedade não será acionado.

Ao abrir uma janela filho chamando ShowDialog, você também deve definir a Owner propriedade 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 Owner propriedade em uma janela aberta chamando ShowDialog para garantir o comportamento correto com .

Observação

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

Confira também

• OwnedWindows