Funzione SetCursorPos (winuser.h)

Articolo
03/04/2024

Sposta il cursore sulle coordinate dello schermo specificate. Se le nuove coordinate non si trovano all'interno del rettangolo dello schermo impostato dalla chiamata di funzione ClipCursor più recente, il sistema regola automaticamente le coordinate in modo che il cursore rimanga all'interno del rettangolo.

Sintassi

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

Parametri

[in] X

Tipo: int

Nuova coordinata x del cursore, nelle coordinate dello schermo.

[in] Y

Tipo: int

Nuova coordinata y del cursore, nelle coordinate dello schermo.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il cursore è una risorsa condivisa. Una finestra deve spostare il cursore solo quando il cursore si trova nell'area client della finestra.

Il processo chiamante deve avere WINSTA_WRITEATTRIBUTES accesso alla stazione finestra.

Il desktop di input deve essere il desktop corrente quando chiami SetCursorPos. Chiama OpenInputDesktop per determinare se il desktop corrente è il desktop di input. In caso contrario, chiamare SetThreadDesktop con HDESK restituito da OpenInputDesktop per passare a tale desktop.

Esempio

Per un esempio, vedere Uso della tastiera per spostare il cursore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-2 (introdotto in Windows 10 versione 10.0.10240)