Compartilhar via


Função ChildWindowFromPointEx (winuser.h)

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)

Confira também

Conceitual

Outros recursos

PONTO

Referência

WindowFromPoint

Windows