Window.Owner Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia Window, który jest właścicielem tego 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

Wartość właściwości

Window

Obiekt Window reprezentujący właściciela tego Window.

Wyjątki

ArgumentException

Okno próbuje być właścicielem samego siebie

-lub-

Dwa okna starają się posiadać siebie nawzajem.

InvalidOperationException

Właściwość Owner jest ustawiana w widocznym oknie wyświetlanym przy użyciu ShowDialog()

-lub-

Właściwość Owner jest ustawiana przy użyciu okna, które nie zostało wcześniej pokazane.

Przykłady

W poniższym przykładzie pokazano, jak ustanowić relację właściciela/właściciela.

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

Uwagi

Po otwarciu okna podrzędnego przez okno nadrzędne przez wywołanie ShowDialogzostanie ustanowiona niejawna relacja między oknem nadrzędnym i podrzędnym. Ta relacja wymusza pewne zachowania, w tym w odniesieniu do minimalizowania, maksymalizacji i przywracania.

Gdy okno podrzędne jest tworzone przez okno nadrzędne przez wywołanie Show, jednak okno podrzędne nie ma relacji z oknem nadrzędnym. Oznacza to, że:

• Okno podrzędne nie ma odwołania do okna nadrzędnego.

• Zachowanie okna podrzędnego nie zależy od zachowania okna nadrzędnego; okno może obejmować inne lub zminimalizować, zmaksymalizować i przywrócić niezależnie od drugiego.

Aby umożliwić tworzenie relacji między oknem podrzędnym a oknem nadrzędnym, Window obsługuje pojęcie własności. Własność jest ustanawiana, gdy właściwość Owner okna (okno należące do użytkownika) jest ustawiana z odwołaniem do innego okna (okno właściciela).

Po ustanowieniu tej relacji są wyświetlane następujące zachowania:

• Jeśli okno właściciela zostanie zminimalizowane, wszystkie okna należące do niego również zostaną zminimalizowane.

• Jeśli okno należące do użytkownika zostanie zminimalizowane, jego właściciel nie zostanie zminimalizowany.

• Jeśli okno właściciela jest zmaksymalizowane, zarówno okno właściciela, jak i jego należące do niego okna zostaną przywrócone.

• Okno właściciela nigdy nie może obejmować okna należącego do użytkownika.

• Okna należące do użytkownika, które nie zostały otwarte przy użyciu ShowDialog, nie są modalne. Użytkownik nadal może wchodzić w interakcję z oknem właściciela.

• Jeśli zamkniesz okno właściciela, jego należące do niego okna również zostaną zamknięte.

• Jeśli okno właściciela zostało otwarte przez okno właściciela przy użyciu Show, a okno właściciela jest zamknięte, zdarzenie Closing okna własności nie jest zgłaszane.

Po otwarciu okna podrzędnego przez wywołanie ShowDialognależy również ustawić właściwość Owner okna podrzędnego. Jeśli tego nie zrobisz, użytkownicy nie będą mogli przywrócić zarówno okna podrzędnego, jak i okna nadrzędnego, naciskając przycisk paska zadań. Zamiast tego naciśnięcie przycisku paska zadań spowoduje wyświetlenie listy okien, w tym okna podrzędnego i nadrzędnego, aby je wybrać; zostanie przywrócone tylko wybrane okno.

Ważny

Należy również ustawić właściwość Owner w oknie otwartym przez wywołanie ShowDialog w celu zapewnienia prawidłowego zachowania w oknie należącym do użytkownika.

Nuta

Nie można ustawić ani pobrać tej właściwości, gdy okno jest hostowane w przeglądarce.

Zobacz też

• OwnedWindows