WindowInteropHelper.EnsureHandle Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skapar HWND för fönstret om HWND inte har skapats ännu.
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 IntPtrReturer
nativeint
En IntPtr som representerar HWND.
- Attribut
Kommentarer
Använd metoden EnsureHandle när du vill separera skapande av fönsterhandtag (HWND) från den faktiska visningen av den hanterade Window. Detta är användbart när du har en Automation-klient som kan utföra sina uppgifter utan att behöva visa ett fönster.
Om det interna fönstret ännu inte har skapats skapar den här metoden det interna fönstret, anger Handle egenskapen och returnerar HWND. Om det interna fönstret redan har skapats returneras handtaget för det befintliga interna fönstret.
Om det interna fönstret skapas som ett resultat av att den här metoden anropas utlöses SourceInitialized händelsen.
När du kör frågor mot Handle egenskapen efter att EnsureHandle metoden anropats returneras det befintliga fönsterhandtaget. Det visuella trädet är inte kopplat till fönstret förrän metoden Show anropas.
EnsureHandle Att anropa metoden mer än en gång skapar inte nya fönsterhandtag. EnsureHandle Att anropa metoden när handtaget redan har skapats av ett anrop till Show metoden skapar inte ett nytt fönsterhandtag. Ett internt fönster skapas bara när det inte finns något handtag när EnsureHandle metoden anropas.
Fönsteregenskaper som anges med hjälp av interna fönster-API:er via p/invoke kanske inte visas i API:erna för det hanterade fönstret. Om du till exempel ställer in att fönstret ska vara längst upp med hjälp av den interna MS_EX_TOPMOST-flaggan efter EnsureHandle att metoden anropats, Topmost är egenskapen inte garanterad att återspegla den interna inställningen.
