WindowInteropHelper.EnsureHandle Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří HWND okna, pokud HWND ještě nebyl vytvořen.
public:
IntPtr EnsureHandle();[System.Security.SecurityCritical]
public IntPtr EnsureHandle();public IntPtr EnsureHandle();[<System.Security.SecurityCritical>]
member this.EnsureHandle : unit -> nativeintmember this.EnsureHandle : unit -> nativeintPublic Function EnsureHandle () As IntPtrNávraty
nativeint
Představuje IntPtr HWND.
- Atributy
Poznámky
Tuto metodu EnsureHandle použijte, pokud chcete oddělit vytváření oken (HWND) od skutečného zobrazení spravovaného Windowobjektu . To je užitečné v případě, že máte klienta automatizace, který dokáže provádět své úkoly, aniž by bylo nutné zobrazit okno.
Pokud nativní okno ještě nebylo vytvořeno, tato metoda vytvoří nativní okno, nastaví Handle vlastnost a vrátí HWND. Pokud již bylo vytvořeno nativní okno, vrátí se popisovač existujícího nativního okna.
Pokud se v důsledku volání této metody vytvoří nativní okno, SourceInitialized vyvolá se událost.
Dotazování na Handle vlastnost po EnsureHandle zavolání metody vrátí existující popisovač okna. Vizuální strom není připojen k oknem, dokud Show není volána metoda.
EnsureHandle Volání metody více než jednou nevytvoří nové popisovače oken. EnsureHandle Volání metody, pokud popisovač již byl vytvořen voláním Show metody nevytvoří nový popisovač okna. Nativní okno se vytvoří pouze v případě, že při zavolání metody neexistuje EnsureHandle žádný popisovač.
Vlastnosti okna nastavené pomocí rozhraní API nativního okna prostřednictvím volání nemusejí být zobrazeny v rozhraních API spravovaných oken. Pokud například nastavíte okno na nejvyšší hodnotu pomocí nativního příznaku MS_EX_TOPMOST po EnsureHandle zavolání metody, není zaručeno, Topmost že tato vlastnost bude odrážet nativní nastavení.
