Função ClientToScreen (winuser.h)
A função ClientToScreen converte as coordenadas da área do cliente de um ponto especificado em coordenadas de tela.
Sintaxe
BOOL ClientToScreen(
[in] HWND hWnd,
[in, out] LPPOINT lpPoint
);
Parâmetros
[in] hWnd
Um identificador para a janela cuja área de cliente é usada para a conversão.
[in, out] lpPoint
Um ponteiro para uma estrutura POINT que contém as coordenadas do cliente a serem convertidas. As novas coordenadas de tela serão copiadas para essa estrutura se a função for bem-sucedida.
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 ClientToScreen substitui as coordenadas da área do cliente na estrutura POINT pelas coordenadas da tela. As coordenadas da tela são relativas ao canto superior esquerdo da tela. Observe que um ponto de coordenadas de tela acima da área de cliente da janela tem uma coordenada y negativa. Da mesma forma, uma coordenada de tela à esquerda de uma área de cliente tem uma coordenada x negativa.
Todas as coordenadas são coordenadas do dispositivo.
Exemplos
Para obter um exemplo, confira "Linhas de desenho com o mouse" em Usando a entrada do mouse.
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