Função SetCursorPos (winuser.h)

Artigo
03/13/2024

Move o cursor para as coordenadas de tela especificadas. Se as novas coordenadas não estiverem dentro do retângulo de tela definido pela chamada de função ClipCursor mais recente, o sistema ajustará automaticamente as coordenadas para que o cursor permaneça dentro do retângulo.

Sintaxe

BOOL SetCursorPos(
  [in] int X,
  [in] int Y
);

Parâmetros

[in] X

Tipo: int

A nova coordenada x do cursor, nas coordenadas da tela.

[in] Y

Tipo: int

A nova coordenada y do cursor, em coordenadas de tela.

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

O cursor é um recurso compartilhado. Uma janela deve mover o cursor somente quando o cursor estiver na área do cliente da janela.

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

A área de trabalho de entrada deve ser a área de trabalho atual quando você chama SetCursorPos. 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)