Share via

Función ChildWindowFromPointEx (winuser.h)

  • Artículo

Determina qué, si existe, de las ventanas secundarias que pertenecen a la ventana primaria especificada contiene el punto especificado. La función puede omitir ventanas secundarias invisibles, deshabilitadas y transparentes. La búsqueda está restringida a ventanas secundarias inmediatas. No se buscan nietos ni descendientes más profundos.

Sintaxis

HWND ChildWindowFromPointEx(
  [in] HWND  hwnd,
  [in] POINT pt,
  [in] UINT  flags
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana primaria.

[in] pt

Tipo: POINT

Estructura que define las coordenadas de cliente (relativas a hwndParent) del punto que se va a comprobar.

[in] flags

Tipo: UINT

Ventanas secundarias que se van a omitir. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
CWP_ALL
0x0000
 No omite ninguna ventana secundaria
CWP_SKIPDISABLED
0x0002
 Omite las ventanas secundarias deshabilitadas
CWP_SKIPINVISIBLE
0x0001
 Omite ventanas secundarias invisibles
CWP_SKIPTRANSPARENT
0x0004
 Omite las ventanas secundarias transparentes

Valor devuelto

Tipo: HWND

El valor devuelto es un identificador de la primera ventana secundaria que contiene el punto y cumple los criterios especificados por uFlags. Si el punto está dentro de la ventana primaria, pero no dentro de ninguna ventana secundaria que cumpla los criterios, el valor devuelto es un identificador de la ventana primaria. Si el punto se encuentra fuera de la ventana primaria o si se produce un error en la función, el valor devuelto es NULL.

Comentarios

El sistema mantiene una lista interna que contiene los identificadores de las ventanas secundarias asociadas a una ventana primaria. El orden de los identificadores de la lista depende del orden Z de las ventanas secundarias. Si más de una ventana secundaria contiene el punto especificado, el sistema devuelve un identificador a la primera ventana de la lista que contiene el punto y cumple los criterios especificados por uFlags.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-window-l1-1-4 (introducido en Windows 10, versión 10.0.14393)

Consulte también

Conceptual

Otros recursos

PUNTO

Referencia

WindowFromPoint

Windows