Funzione ClipCursor (winuser.h)
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 |
Vedi anche
Informazioni concettuali
Altre risorse
Riferimento