WindowInteropHelper.EnsureHandle Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée le HWND de la fenêtre si celui-ci n'a pas encore été créé.
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 IntPtrRetours
nativeint
IntPtr qui représente le HWND.
- Attributs
Remarques
Utilisez la EnsureHandle méthode lorsque vous souhaitez séparer la création de handle de fenêtre (HWND) de l’affichage réel du managé Window. Cela est utile lorsque vous disposez d’un client Automation qui peut accomplir ses tâches sans avoir besoin d’afficher une fenêtre.
Si la fenêtre native n’a pas encore été créée, cette méthode crée la fenêtre native, définit la Handle propriété et retourne le HWND. Si la fenêtre native a déjà été créée, le handle de la fenêtre native existante est retourné.
Si la fenêtre native est créée à la suite de l’appel de cette méthode, l’événement SourceInitialized est déclenché.
L’interrogation de la Handle propriété après l’appel de la EnsureHandle méthode renvoie le handle de fenêtre existant. L’arborescence visuelle n’est pas attachée à la fenêtre tant que la Show méthode n’est pas appelée.
L’appel de la EnsureHandle méthode plusieurs fois ne crée pas de nouveaux handles de fenêtre. L’appel de la EnsureHandle méthode lorsque le handle a déjà été créé par un appel à la Show méthode ne crée pas de handle de fenêtre. Une fenêtre native n’est créée que lorsqu’il n’existe aucun handle lorsque la EnsureHandle méthode est appelée.
Les propriétés de fenêtre définies à l’aide des API de fenêtre natives via p/invoke peuvent ne pas apparaître dans les API de fenêtre managée. Par exemple, si vous définissez la fenêtre sur la plus haute en utilisant l’indicateur de MS_EX_TOPMOST natif après l’appel de la EnsureHandle méthode, la Topmost propriété n’est pas garantie de refléter le paramètre natif.
