Funzione ClipCursor (winuser.h)

Articolo
03/04/2024

Limita il cursore a un'area rettangolare sullo schermo. Se una posizione del cursore successiva (impostata dalla funzione SetCursorPos o dal mouse) si trova all'esterno del rettangolo, il sistema regola automaticamente la posizione per mantenere il cursore all'interno dell'area rettangolare.

Sintassi

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

Parametri

[in, optional] lpRect

Tipo: const RECT*

Puntatore alla struttura contenente le coordinate dello schermo degli angoli superiore sinistro e inferiore destro del rettangolo di confine. Se questo parametro è NULL, il cursore è libero di spostarsi ovunque sullo schermo.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il cursore è una risorsa condivisa. Se un'applicazione limita il cursore, deve rilasciare il cursore usando ClipCursor prima di rimettere il controllo in un'altra applicazione.

Il processo chiamante deve avere WINSTA_WRITEATTRIBUTES accesso alla stazione finestra.

Esempio

Per un esempio, vedere Limiti di un 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