Condividi tramite


Funzione SetCursor (winuser.h)

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

Vedi anche

Informazioni concettuali

Cursori

Creazione di un cursore

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

Loadimage

Riferimento

SetCursorPos

ShowCursor