WindowInteropHelper.EnsureHandle Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt u de HWND van het venster als de HWND nog niet is gemaakt.
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 IntPtrRetouren
nativeint
Een IntPtr die de HWND vertegenwoordigt.
- Kenmerken
Opmerkingen
Gebruik de EnsureHandle methode als u het maken van een venstergreep (HWND) wilt scheiden van de werkelijke weergave van de beheerde Window. Dit is handig wanneer u een automatiseringsclient hebt die de taken kan uitvoeren zonder dat er een venster hoeft te worden weergegeven.
Als het systeemeigen venster nog niet is gemaakt, maakt deze methode het systeemeigen venster, stelt u de Handle eigenschap in en retourneert u de HWND. Als het systeemeigen venster al is gemaakt, wordt de ingang van het bestaande systeemeigen venster geretourneerd.
Als het systeemeigen venster wordt gemaakt als gevolg van het aanroepen van deze methode, wordt de SourceInitialized gebeurtenis gegenereerd.
Als u een query op de Handle eigenschap uitvoert nadat de EnsureHandle methode is aangeroepen, wordt de bestaande venstergreep geretourneerd. De visualstructuur wordt pas aan het venster gekoppeld nadat de Show methode is aangeroepen.
Als u de EnsureHandle methode meer dan één keer aanroept, worden er geen nieuwe venstergrepen gemaakt. Het aanroepen van de EnsureHandle methode wanneer de ingang al is gemaakt door een aanroep naar de Show methode, maakt geen nieuwe venstergreep. Er wordt alleen een systeemeigen venster gemaakt wanneer er geen ingang bestaat wanneer de EnsureHandle methode wordt aangeroepen.
Venstereigenschappen die zijn ingesteld met behulp van systeemeigen venster-API's via p/invoke, worden mogelijk niet weergegeven in de beheerde venster-API's. Als u bijvoorbeeld het venster instelt op het hoogste punt met behulp van de systeemeigen MS_EX_TOPMOST vlag nadat de EnsureHandle methode is aangeroepen, is de Topmost eigenschap niet gegarandeerd om de systeemeigen instelling weer te geven.
