Função GetCursorPos (winuser.h)

Artigo
03/13/2024

Recupera a posição do cursor do mouse, em coordenadas de tela.

Sintaxe

BOOL GetCursorPos(
  [out] LPPOINT lpPoint
);

Parâmetros

[out] lpPoint

Tipo: LPPOINT

Um ponteiro para uma estrutura POINT que recebe as coordenadas de tela do cursor.

Retornar valor

Tipo: BOOL

Retornará diferente de zero se tiver êxito ou zero caso contrário. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A posição do cursor é sempre especificada nas coordenadas da tela e não é afetada pelo modo de mapeamento da janela que contém o cursor.

O processo de chamada deve ter WINSTA_READATTRIBUTES acesso à estação de janela.

A área de trabalho de entrada deve ser a área de trabalho atual quando você chama GetCursorPos. Chame OpenInputDesktop para determinar se a área de trabalho atual é a área de trabalho de entrada. Se não estiver, chame SetThreadDesktop com o HDESK retornado por OpenInputDesktop para alternar para essa área de trabalho.

Exemplos

Para obter um exemplo, consulte Usando o teclado para mover o cursor.

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)