Funzione CreateCursor (winuser.h)

Articolo
11/20/2024

Crea un cursore monocromatico con le dimensioni, i modelli di bit e il punto critico specificati.

Per creare un cursore colorato in fase di esecuzione, è possibile utilizzare la funzione CreateIconIndirect , che crea un cursore basato sul 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 per l'istanza corrente dell'applicazione che crea il cursore.

[in] xHotSpot

Tipo: int

Posizione orizzontale del punto attivo del cursore.

[in] yHotSpot

Tipo: int

Posizione verticale del punto attivo del cursore.

[in] nWidth

Tipo: int

Larghezza del cursore, espressa in pixel.

[in] nHeight

Tipo: int

Altezza del cursore, in pixel.

[in] pvANDPlane

Tipo: const VOID*

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

[in] pvXORPlane

Tipo: const VOID*

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

Valore restituito

Tipo: HCURSOR

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

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

Osservazioni

Per determinare le dimensioni nominale di un cursore, utilizzare la funzione getSystemMetrics , specificando il valore SM_CXCURSOR o SM_CYCURSOR. È anche possibile usare la versione compatibile con DPI di questa API, vedere GetSystemMetricsForDpi. Per altre informazioni, vedere Sviluppo di applicazioni desktop con valori DPI elevati in Windows.

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

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

Maschera di bit AND	Maschera di bit XOR	Esporre
0	0	Nero
0	1	Bianco
1	0	Schermo
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 dal dpi del thread chiamante. Si noti che il cursore creato può comunque essere ridimensionato in modo che corrisponda al valore DPI di una determinata finestra in cui viene disegnato.

Esempi

Per un esempio, vedere Creazione di un cursore.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll