Funzione CreateCursor (winuser.h)

Articolo
01/27/2024

Crea un cursore monocromatico con dimensioni, modelli di bit e punto di accesso frequente specificati.

Per creare un cursore colorato in fase di esecuzione, è possibile usare la funzione CreateIconIndirect , che crea un cursore in base al contenuto di una struttura ICONINFO .

Sintassi

HCURSOR CreateCursor(
  [in, optional] HINSTANCE  hInst,
  [in]           int        xHotSpot,
  [in]           int        yHotSpot,
  [in]           int        nWidth,
  [in]           int        nHeight,
  [in]           const VOID *pvANDPlane,
  [in]           const VOID *pvXORPlane
);

Parametri

[in, optional] hInst

Tipo: HINSTANCE

Handle all'istanza corrente dell'applicazione che crea il cursore.

[in] xHotSpot

Tipo: int

Posizione orizzontale del punto caldo del cursore.

[in] yHotSpot

Tipo: int

Posizione verticale del punto caldo del cursore.

[in] nWidth

Tipo: int

Larghezza del cursore, in pixel.

[in] nHeight

Tipo: int

Altezza del cursore, in pixel.

[in] pvANDPlane

Tipo: const VOID*

Matrice di byte che contiene i valori bit per la maschera AND del cursore, come in una bitmap monocromatica. Vedere la sezione Osservazioni.

[in] pvXORPlane

Tipo: const VOID*

Matrice di byte che contiene i valori bit per la maschera XOR del cursore, come in una bitmap monocromatica. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HCURSOR

Se la funzione ha esito positivo, il valore restituito è un handle al cursore.

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

Commenti

Per determinare le dimensioni nominale di un cursore, usare la funzione GetSystemMetrics , specificando il valore SM_CXCURSOR o SM_CYCURSOR . È anche possibile usare la versione con riconoscimento DPI di questa API, vedere (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Per altre informazioni, vedere Sviluppo di applicazioni desktop DPI elevate in Windows.

Per altre informazioni sui parametri pvANDPlane e pvXORPlane, vedere la descrizione del parametro lpBits della funzione CreateBitmap.

CreateCursor applica la tabella di verità seguente alle maschera di bit AND e XOR:

Maschera di bit AND	Maschera di bit XOR	Visualizza
0	0	Black
0	1	White
1	0	Screen
1	1	Schermata inversa

Prima di chiudere, un'applicazione deve chiamare la funzione DestroyCursor per liberare tutte le risorse di sistema associate al cursore.

Virtualizzazione DPI

Questa API non partecipa alla virtualizzazione DPI. L'output restituito è in termini di coordinate fisiche e non è interessato dalla DPI del thread chiamante. Si noti che il cursore creato può comunque essere ridimensionato in modo da corrispondere alla DPI di qualsiasi finestra specificata in cui viene disegnato.

Esempio

Per un esempio, vedere Creazione di un cursore.

Requisiti


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