Funzione SetCursor (winuser.h)

Articolo
03/04/2024

Imposta la forma del cursore.

Sintassi

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

Parametri

[in, optional] hCursor

Tipo: HCURSOR

Handle per il cursore.

Il cursore deve essere stato creato dalla funzione CreateCursor o CreateIconIndirect oppure caricata dalla funzione LoadCursor o LoadImage .

Se questo parametro è NULL, il cursore viene rimosso dalla schermata.

Valore restituito

Tipo: HCURSOR

Il valore restituito è l'handle del cursore precedente, se presente.

Se non è presente alcun cursore precedente, il valore restituito è NULL.

Commenti

Il cursore viene impostato solo se il nuovo cursore è diverso dal cursore precedente; in caso contrario, la funzione restituisce immediatamente.

Il cursore è una risorsa condivisa. Una finestra deve impostare la forma del cursore solo quando il cursore si trova nell'area client o quando la finestra acquisisce l'input del mouse. Nei sistemi senza mouse, la finestra deve ripristinare il cursore precedente prima che il cursore lasci l'area client o prima di abbandonare il controllo a un'altra finestra.

Se l'applicazione deve impostare il cursore mentre si trova in una finestra, assicurarsi che il cursore della classe della finestra specificata sia impostato su NULL. Se il cursore della classe non è NULL, il sistema ripristina il cursore della classe ogni volta che il mouse viene spostato.

Il cursore non viene visualizzato sullo schermo se il numero di visualizzazione del cursore interno è minore di zero. Ciò si verifica se l'applicazione usa la funzione ShowCursor per nascondere il cursore più volte rispetto a visualizzare il cursore.

Esempio

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