Função ChildWindowFromPoint (winuser.h)
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) |
Confira também
Conceitual
Outros recursos
Referência