WindowInteropHelper.EnsureHandle Méthode

public:
 IntPtr EnsureHandle();

[System.Security.SecurityCritical]
public IntPtr EnsureHandle ();

public IntPtr EnsureHandle ();

[<System.Security.SecurityCritical>]
member this.EnsureHandle : unit -> nativeint

member this.EnsureHandle : unit -> nativeint

Public Function EnsureHandle () As IntPtr

Retours

IntPtr qui représente le HWND.

Attributs

SecurityCriticalAttribute

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.

S’applique à