Função ScreenToClient (winuser.h)

Artigo
03/15/2023

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)