Condividi tramite


Funzione SetCursorPos (winuser.h)

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)

Vedi anche

ClipCursor

Informazioni concettuali

Cursori

GetCursorPos

Riferimento

SetCaretPos

Setcursor

ShowCursor