Compartilhar via


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

Clienttoscreen

Coordenar funções de espaço e transformação

Visão geral de espaços de coordenadas e transformações

Mapwindowpoints

PONTO