Função ChildWindowFromPointEx (winuser.h)

Artigo
08/27/2023

Determina qual, se houver, das janelas filho pertencentes à janela pai especificada contém o ponto especificado. A função pode ignorar janelas filho invisíveis, desabilitadas e transparentes. A pesquisa é restrita a janelas filho imediatas. Netos e descendentes mais profundos não são pesquisados.

Sintaxe

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

Parâmetros

[in] hwnd

Digite: HWND

Um identificador para a janela pai.

[in] pt

Tipo: POINT

Uma estrutura que define as coordenadas do cliente (em relação a hwndParent) do ponto a ser verificado.

[in] flags

Tipo: UINT

As janelas filho a serem ignoradas. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CWP_ALL 0x0000	Não ignora janelas filho
CWP_SKIPDISABLED 0x0002	Ignora janelas filho desabilitadas
CWP_SKIPINVISIBLE 0x0001	Ignora janelas filho invisíveis
CWP_SKIPTRANSPARENT 0x0004	Ignora janelas filho transparentes

Retornar valor

Digite: HWND

O valor retornado é um identificador para a primeira janela filho que contém o ponto e atende aos critérios especificados por uFlags. Se o ponto estiver dentro da janela pai, mas não dentro de qualquer janela filho que atenda aos critérios, o valor retornado será um identificador para a janela pai. Se o ponto estiver fora da janela pai ou se a função falhar, o valor retornado será NULL.

Comentários

O sistema mantém uma lista interna que contém os identificadores das janelas filho associadas a uma janela pai. A ordem dos identificadores na lista depende da ordem Z das janelas filho. Se mais de uma janela filho contiver o ponto especificado, o sistema retornará um identificador para a primeira janela da lista que contém o ponto e atenderá aos critérios especificados por uFlags.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-4 (introduzido no Windows 10, versão 10.0.14393)