WindowInteropHelper.EnsureHandle Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea el identificador HWND de la ventana si aún no se ha creado.
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 IntPtrDevoluciones
nativeint
IntPtr que representa el identificador HWND.
- Atributos
Comentarios
Use el método cuando desee separar la EnsureHandle creación del identificador de ventana (HWND) de la presentación real de la instancia administrada Window. Esto resulta útil cuando tiene un cliente de automatización que puede realizar sus tareas sin necesidad de mostrar una ventana.
Si aún no se ha creado la ventana nativa, este método crea la ventana nativa, establece la Handle propiedad y devuelve el HWND. Si ya se ha creado la ventana nativa, se devuelve el identificador de la ventana nativa existente.
Si la ventana nativa se crea como resultado de llamar a este método, se genera el SourceInitialized evento .
La consulta de la Handle propiedad después de llamar al EnsureHandle método devuelve el identificador de ventana existente. El árbol visual no se adjunta a la ventana hasta que se llama al Show método .
Llamar al EnsureHandle método más de una vez no crea nuevos identificadores de ventana. Llamar al EnsureHandle método cuando ya se ha creado el identificador mediante una llamada al Show método no crea un nuevo identificador de ventana. Una ventana nativa solo se crea cuando no existe ningún identificador cuando se llama al EnsureHandle método .
Es posible que las propiedades de ventana que se establecen mediante las API de ventana nativas a través de p/invoke no aparezcan en las API de ventana administrada. Por ejemplo, si establece la ventana en la parte superior mediante la marca de MS_EX_TOPMOST nativa después de llamar al EnsureHandle método , no se garantiza que la Topmost propiedad refleje la configuración nativa.
