WindowInteropHelper.EnsureHandle Yöntem

Tanım

Ad Alanı:

System.Windows.Interop

Bütünleştirilmiş Kod:

PresentationFramework.dll

HWND henüz oluşturulmadıysa pencerenin HWND'sini oluşturur.

public:
 IntPtr EnsureHandle();

public IntPtr EnsureHandle ();

member this.EnsureHandle : unit -> nativeint

Public Function EnsureHandle () As IntPtr

Döndürülenler

IntPtr

nativeint

IntPtr HWND'yi temsil eden bir.

Açıklamalar

EnsureHandle Pencere tanıtıcısı (HWND) oluşturma işlemini yönetilen Windowöğesinin gerçek gösteriminden ayırmak istediğinizde yöntemini kullanın. Bu, bir pencere göstermeye gerek kalmadan görevlerini gerçekleştirebilen bir otomasyon istemciniz olduğunda kullanışlıdır.

Yerel pencere henüz oluşturulmadıysa, bu yöntem yerel pencereyi oluşturur, özelliği ayarlar Handle ve HWND'yi döndürür. Yerel pencere zaten oluşturulduysa, mevcut yerel pencerenin tutamacı döndürülür.

Bu yöntemin çağrılması sonucu yerel pencere oluşturulursa, SourceInitialized olay oluşturulur.

Handle Yöntemi çağrıldıktan sonra özelliği sorgulamak EnsureHandle mevcut pencere tutamacını döndürür. Yöntem çağrılana kadar görsel ağaç pencereye Show eklenmez.

EnsureHandle yöntemini birden çok kez çağırmak yeni pencere tanıtıcıları oluşturmaz. Tanıtıcı yöntemine EnsureHandle yapılan bir çağrı tarafından zaten oluşturulduğunda yöntemini çağırmak Show yeni bir pencere tutamacı oluşturmaz. Yerel pencere yalnızca yöntem çağrıldığında hiçbir tanıtıcı mevcut olmadığında EnsureHandle oluşturulur.

p/invoke aracılığıyla yerel pencere API'leri kullanılarak ayarlanan pencere özellikleri yönetilen pencere API'lerinde görünmeyebilir. Örneğin, yöntem çağrıldıktan sonra EnsureHandle yerel MS_EX_TOPMOST bayrağını kullanarak pencereyi en üstte olacak şekilde ayarlarsanız, özelliğin Topmost yerel ayarı yansıtması garanti değildir.