Função GetMessagePos (winuser.h)

Artigo
03/13/2024

Recupera a posição do cursor para a última mensagem recuperada pela função GetMessage .

Para determinar a posição atual do cursor, use a função GetCursorPos .

Sintaxe

DWORD GetMessagePos();

Retornar valor

Tipo: DWORD

O valor retornado especifica as coordenadas x e y da posição do cursor. A coordenada x é a ordem baixa curta e a coordenada y é a abreviação de alta ordem.

Comentários

Conforme observado acima, a coordenada x está na ordem inferior curto do valor retornado; a coordenada y está na ordem superior curto (ambos representam valores assinados, porque podem usar valores negativos em sistemas com vários monitores). Se o valor retornado for atribuído a uma variável, você poderá usar a macro MAKEPOINTS para obter uma estrutura POINTS do valor retornado. Você também pode usar a macro GET_X_LPARAM ou GET_Y_LPARAM para extrair a coordenada X ou Y.

Importante Não use as macros LOWORD ou HIWORD para extrair as coordenadas x e y da posição do cursor porque essas macros retornam resultados incorretos em sistemas com vários monitores. Sistemas com vários monitores podem ter coordenadas x e y negativas, e LOWORD e HIWORD tratam as coordenadas como quantidades sem sinal.

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-message-l1-1-1 (introduzido em Windows 8.1)