Función ChildWindowFromPoint (winuser.h)

Artículo
03/15/2023

Determina qué, si existe, de las ventanas secundarias que pertenecen a una ventana primaria contiene el punto especificado. La búsqueda está restringida a ventanas secundarias inmediatas. Los nietos y las ventanas descendientes más profundas no se buscan.

Para omitir determinadas ventanas secundarias, use la función ChildWindowFromPointEx .

Sintaxis

HWND ChildWindowFromPoint(
  [in] HWND  hWndParent,
  [in] POINT Point
);

Parámetros

[in] hWndParent

Tipo: HWND

Identificador de la ventana primaria.

[in] Point

Tipo: POINT

Estructura que define las coordenadas del cliente, relativas a hWndParent, del punto que se va a comprobar.

Valor devuelto

Tipo: HWND

El valor devuelto es un identificador para la ventana secundaria que contiene el punto, incluso si la ventana secundaria está oculta o deshabilitada. Si el punto está fuera de la ventana primaria, el valor devuelto es NULL. Si el punto está dentro de la ventana primaria, pero no dentro de ninguna ventana secundaria, el valor devuelto es un identificador de la ventana primaria.

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.

ChildWindowFromPoint trata un área HTTRANSPARENT de un control estándar igual que otras partes del control. En cambio, RealChildWindowFromPoint trata un área HTTRANSPARENT de forma diferente; devuelve la ventana secundaria detrás de un área transparente de un control. Por ejemplo, si el punto está en un área transparente de un cuadro de grupo, ChildWindowFromPoint devuelve el cuadro de grupo mientras RealChildWindowFromPoint devuelve la ventana secundaria detrás del cuadro de grupo. Sin embargo, ambas API devuelven un campo estático, aunque también, devuelve HTTRANSPARENT.

Ejemplos

Para obtener un ejemplo, vea "Crear una barra de herramientas de cuadro combinado" en Usar cuadros combinados.

Requisitos


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 (incluya 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)