WindowInteropHelper.EnsureHandle Methode

Definition

Namespace:

System.Windows.Interop

Assembly:

PresentationFramework.dll

Erstellt den HWND des Fensters, wenn der HWND noch nicht erstellt wurde.

public:
 IntPtr EnsureHandle();

public IntPtr EnsureHandle ();

member this.EnsureHandle : unit -> nativeint

Public Function EnsureHandle () As IntPtr

Gibt zurück

IntPtr

nativeint

Ein IntPtr, das den HWND darstellt.

Hinweise

Verwenden Sie die -Methode, wenn Sie die EnsureHandle Erstellung des Fensterhandles (HWND) von der tatsächlichen Anzeige des verwalteten Windowtrennen möchten. Dies ist nützlich, wenn Sie über einen Automatisierungsclient verfügen, der seine Aufgaben ausführen kann, ohne dass ein Fenster angezeigt werden muss.

Wenn das native Fenster noch nicht erstellt wurde, erstellt diese Methode das systemeigene Fenster, legt die Handle Eigenschaft fest und gibt den HWND zurück. Wenn das native Fenster bereits erstellt wurde, wird das Handle des vorhandenen systemeigenen Fensters zurückgegeben.

Wenn das systemeigene Fenster als Ergebnis des Aufrufens dieser Methode erstellt wird, wird das SourceInitialized Ereignis ausgelöst.

Das Abfragen der Handle -Eigenschaft nach dem Aufruf der EnsureHandle Methode gibt das vorhandene Fensterhandle zurück. Die visuelle Struktur wird erst an das Fenster angefügt, nachdem die Show Methode aufgerufen wurde.

Wenn Sie die EnsureHandle Methode mehrmals aufrufen, werden keine neuen Fensterhandles erstellt. Durch das Aufrufen der EnsureHandle -Methode, wenn das Handle bereits durch einen Aufruf der Show -Methode erstellt wurde, wird kein neues Fensterhandle erstellt. Ein systemeigenes Fenster wird nur erstellt, wenn beim Aufrufen der EnsureHandle Methode kein Handle vorhanden ist.

Fenstereigenschaften, die mithilfe nativer Fenster-APIs über p/invoke festgelegt werden, werden möglicherweise nicht in den APIs für verwaltete Fenster angezeigt. Wenn Sie beispielsweise das Fenster auf oberster Stelle festlegen, indem Sie das native MS_EX_TOPMOST-Flag verwenden, nachdem die EnsureHandle Methode aufgerufen wurde, wird die Topmost -Eigenschaft nicht garantiert, dass sie die native Einstellung widerspiegelt.