Window.Owner Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur Window yang memiliki Windowini.

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

Nilai Properti

Window

Objek Window yang mewakili pemilik Windowini.

Pengecualian

ArgumentException

Jendela mencoba untuk memiliki dirinya sendiri

-atau-

Dua jendela mencoba untuk memiliki satu sama lain.

InvalidOperationException

Properti Owner diatur pada jendela yang terlihat yang ditampilkan menggunakan ShowDialog()

-atau-

Properti Owner diatur dengan jendela yang sebelumnya belum ditampilkan.

Contoh

Contoh berikut menunjukkan cara membuat hubungan pemilik/milik.

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

Keterangan

Ketika jendela anak dibuka oleh jendela induk dengan memanggil ShowDialog, hubungan implisit dibuat antara jendela induk dan anak. Hubungan ini memberlakukan perilaku tertentu, termasuk sehubungan dengan meminimalkan, memaksimalkan, dan memulihkan.

Ketika jendela anak dibuat oleh jendela induk dengan memanggil Show, namun, jendela anak tidak memiliki hubungan dengan jendela induk. Ini berarti bahwa:

• Jendela anak tidak memiliki referensi ke jendela induk.

• Perilaku jendela anak tidak tergantung pada perilaku jendela induk; salah satu jendela dapat mencakup yang lain, atau diminimalkan, dimaksimalkan, dan dipulihkan secara independen dari yang lain.

Untuk memungkinkan Anda membuat hubungan antara jendela anak dan jendela induk, Window mendukung gagasan kepemilikan. Kepemilikan ditetapkan ketika properti Owner jendela (jendela yang dimiliki) diatur dengan referensi ke jendela lain (jendela pemilik).

Setelah hubungan ini terjalin, perilaku berikut dipamerkan:

• Jika jendela pemilik diminimalkan, semua jendela yang dimiliki juga diminimalkan.

• Jika jendela yang dimiliki diminimalkan, pemiliknya tidak diminimalkan.

• Jika jendela pemilik dimaksimalkan, jendela pemilik dan jendela miliknya akan dipulihkan.

• Jendela pemilik tidak pernah dapat menutupi jendela yang dimiliki.

• Jendela yang dimiliki yang tidak dibuka menggunakan ShowDialog tidak modal. Pengguna masih dapat berinteraksi dengan jendela pemilik.

• Jika Anda menutup jendela pemilik, jendela miliknya juga ditutup.

• Jika jendela yang dimiliki dibuka oleh jendela pemiliknya menggunakan Show, dan jendela pemilik ditutup, peristiwa Closing jendela yang dimiliki tidak dinaikkan.

Saat Anda membuka jendela anak dengan memanggil ShowDialog, Anda juga harus mengatur properti Owner jendela anak. Jika tidak, maka pengguna Anda tidak akan dapat memulihkan jendela anak dan jendela induk dengan menekan tombol bilah tugas. Sebagai gantinya, menekan tombol bilah tugas akan menghasilkan daftar jendela, termasuk jendela turunan dan induk, agar dipilih; hanya jendela terpilih yang dipulihkan.

Penting

Anda juga harus mengatur properti Owner pada jendela yang dibuka dengan memanggil ShowDialog untuk memastikan perilaku yang benar dengan jendela yang dimiliki.

Nota

Anda tidak dapat mengatur atau mendapatkan properti ini ketika jendela dihosting di browser.

Lihat juga

• OwnedWindows