Função SetCursorPos (winuser.h)
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) |
Confira também
Conceitual
Referência