Função ScreenToClient (winuser.h)
A função ScreenToClient converte as coordenadas de tela de um ponto especificado na tela em coordenadas da área do cliente.
Sintaxe
BOOL ScreenToClient(
[in] HWND hWnd,
LPPOINT lpPoint
);
Parâmetros
[in] hWnd
Um identificador para a janela cuja área de cliente será usada para a conversão.
lpPoint
Um ponteiro para uma estrutura POINT que especifica as coordenadas de tela a serem convertidas.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero.
Comentários
A função usa a janela identificada pelo parâmetro hWnd e as coordenadas de tela fornecidas na estrutura POINT para calcular as coordenadas do cliente. Em seguida, ele substitui as coordenadas da tela pelas coordenadas do cliente. As novas coordenadas são relativas ao canto superior esquerdo da área de cliente da janela especificada.
A função ScreenToClient pressupõe que o ponto especificado esteja nas coordenadas da tela.
Todas as coordenadas estão em unidades de dispositivo.
Não use ScreenToClient quando estiver em uma situação de espelhamento, ou seja, ao alterar do layout da esquerda para a direita para o layout da direita para a esquerda. Em vez disso, use MapWindowPoints. Para obter mais informações, confira "Layout e espelhamento de janela" em Recursos de janela.
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-2 (introduzido no Windows 10, versão 10.0.10240) |
Confira também
Coordenar funções de espaço e transformação