Window.Owner Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.