Funzione SetSystemCursor (winuser.h)

Articolo
03/13/2024

Consente a un'applicazione di personalizzare i cursori di sistema. Sostituisce il contenuto del cursore di sistema specificato dal parametro ID con il contenuto del cursore specificato dal parametro hcur e quindi elimina hcur.

Sintassi

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

Parametri

[in] hcur

Tipo: HCURSOR

Handle al cursore. La funzione sostituisce il contenuto del cursore di sistema specificato dall'ID con il contenuto del cursore gestito da hcur.

Il sistema elimina hcur chiamando la funzione DestroyCursor . Pertanto , hcur non può essere un cursore caricato usando la funzione LoadCursor . Per specificare un cursore caricato da una risorsa, copiare il cursore usando la funzione CopyCursor , quindi passare la copia a SetSystemCursor.

[in] id

Tipo: DWORD

Cursore di sistema da sostituire con il contenuto di hcur. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
OCR_NORMAL `32512`	Selezione normale
OCR_IBEAM `32513`	Selezione testo
OCR_WAIT `32514`	Busy
OCR_CROSS `32515`	Selezione precisione
OCR_UP `32516`	Selezione alternativa
OCR_SIZENWSE `32642`	Ridimensionamento diagonale 1
OCR_SIZENESW `32643`	Ridimensionamento diagonale 2
OCR_SIZEWE `32644`	Ridimensionamento orizzontale
OCR_SIZENS `32645`	Ridimensionamento verticale
OCR_SIZEALL `32646`	Move
OCR_NO `32648`	Non disponibile
OCR_HAND `32649`	Selezione collegamento
OCR_APPSTARTING `32650`	Lavoro in background

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

Per consentire a un'applicazione di usare una delle costanti OCR_, è necessario definire la costante OEMRESOURCE prima dell'inserimento del file di intestazione Windows.h.

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