Window.Owner Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um objeto Window que representa o proprietário deste Window.
- Atributos
Exceções
Uma janela tenta pertencer a si mesma
- ou -
Duas janelas tentam pertencer uma a outra.
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.
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de