Bagikan melalui

Window.Owner Properti

  • Referensi

Definisi

Ruang nama:
System.Windows
Rakitan:
PresentationFramework.dll

Mendapatkan atau mengatur Window yang memiliki ini Window.

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

Nilai Properti

Window

Objek Window yang mewakili pemilik ini Window.

Atribut
SecurityCriticalAttribute

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 belum ditampilkan sebelumnya.

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; baik jendela dapat mencakup jendela 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 Owner properti 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 yang dimilikinya 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 jendela Closing yang dimiliki tidak dinaikkan.

Saat Anda membuka jendela anak dengan memanggil ShowDialog, Anda juga harus mengatur Owner properti 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 mereka dapat memilih; hanya jendela yang dipilih yang dipulihkan.

Penting

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

Catatan

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

Berlaku untuk

Lihat juga