Funzione CreateCursor (winuser.h)
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 |