Função ChildWindowFromPoint (winuser.h)

Artigo
08/27/2023

Determina qual, se houver, das janelas filho pertencentes a uma janela pai contém o ponto especificado. A pesquisa é restrita a janelas filho imediatas. Netos e janelas descendentes mais profundas não são pesquisados.

Para ignorar determinadas janelas filho, use a função ChildWindowFromPointEx .

Sintaxe

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

Parâmetros

[in] hWndParent

Digite: HWND

Um identificador para a janela pai.

[in] Point

Tipo: POINT

Uma estrutura que define as coordenadas do cliente, em relação a hWndParent, do ponto a ser verificado.

Valor retornado

Digite: HWND

O valor retornado é um identificador para a janela filho que contém o ponto, mesmo que a janela filho esteja oculta ou desabilitada. Se o ponto estiver fora da janela pai, o valor retornado será NULL. Se o ponto estiver dentro da janela pai, mas não dentro de nenhuma janela filho, o valor retornado será um identificador para a janela pai.

Comentários

O sistema mantém uma lista interna, contendo 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.

ChildWindowFromPoint trata uma área HTTRANSPARENT de um controle padrão da mesma forma que outras partes do controle. Por outro lado, RealChildWindowFromPoint trata uma área HTTRANSPARENT de forma diferente; retorna a janela filho atrás de uma área transparente de um controle. Por exemplo, se o ponto estiver em uma área transparente de uma caixa de grupo, ChildWindowFromPoint retornará a caixa de grupo enquanto RealChildWindowFromPoint retornará a janela filho atrás da caixa de grupo. No entanto, ambas as APIs retornam um campo estático, embora ele também retorne HTTRANSPARENT.

Exemplos

Para obter um exemplo, consulte "Criando uma barra de ferramentas de caixa de combinação" em Usando caixas de combinação.

Requisitos


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)