Bagikan melalui

WindowInteropHelper.EnsureHandle Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Interop
Rakitan:
PresentationFramework.dll

Membuat HWND jendela jika HWND belum dibuat.

public:
 IntPtr EnsureHandle();
[System.Security.SecurityCritical]
public IntPtr EnsureHandle ();
public IntPtr EnsureHandle ();
[<System.Security.SecurityCritical>]
member this.EnsureHandle : unit -> nativeint
member this.EnsureHandle : unit -> nativeint
Public Function EnsureHandle () As IntPtr

Mengembalikan

IntPtr

nativeint

Yang IntPtr mewakili HWND.

Atribut
SecurityCriticalAttribute

Keterangan

EnsureHandle Gunakan metode ketika Anda ingin memisahkan pembuatan handel jendela (HWND) dari pertunjukan aktual yang dikelola Window. Ini berguna ketika Anda memiliki klien otomatisasi yang dapat menyelesaikan tugasnya tanpa perlu menampilkan jendela.

Jika jendela asli belum dibuat, metode ini membuat jendela asli, mengatur Handle properti , dan mengembalikan HWND. Jika jendela asli telah dibuat, handel jendela asli yang ada dikembalikan.

Jika jendela asli dibuat sebagai akibat dari memanggil metode ini, SourceInitialized peristiwa akan dinaikkan.

Mengkueri Handle properti setelah EnsureHandle metode disebut mengembalikan handel jendela yang ada. Pohon visual tidak dilampirkan ke jendela sampai setelah Show metode dipanggil.

Memanggil EnsureHandle metode lebih dari satu kali tidak membuat handel jendela baru. Memanggil EnsureHandle metode ketika handel telah dibuat oleh panggilan ke Show metode tidak membuat handel jendela baru. Jendela asli hanya dibuat ketika tidak ada handel saat metode dipanggil EnsureHandle .

Properti jendela yang diatur dengan menggunakan API jendela asli melalui p/invoke mungkin tidak muncul di API jendela terkelola. Misalnya, jika Anda mengatur jendela menjadi yang paling atas dengan menggunakan bendera MS_EX_TOPMOST asli setelah EnsureHandle metode dipanggil, Topmost properti tidak dijamin untuk mencerminkan pengaturan asli.

Berlaku untuk