WindowInteropHelper.EnsureHandle Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
HWND henüz oluşturulmadıysa pencerenin HWND'sini oluşturur.
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
Döndürülenler
nativeint
IntPtr HWND'yi temsil eden bir.
- Öznitelikler
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.