CreateCursor

La funzione CreateCursor crea un cursore avendo la dimensione specificata, schemi di bit e hot spot.

(HCURSOR CreateCursor HINSTANCE  hInst, / / handle all'istanza dell'applicazioneintxHotSpot, / / posizione orizzontale di hot spotintyHotSpot, / / posizione verticale di hot spotintnWidth, / / larghezza del cursore intnHeight, / / altezza del cursoreCONST VOID* pvANDPlane, / / puntatore a matrice di maschera di bit eCONST VOID* pvXORPlane / / puntatore a matrice di maschera di bit XOR);
 

Parametri

hInst
Gestire all'istanza corrente dell'applicazione creando il cursore.
xHotSpot
Specifica la posizione orizzontale del punto caldo del cursore.
yHotSpot
Specifica la posizione verticale di punto caldo del cursore.
nWidth
Specifica la larghezza in pixel del cursore.
nHeight
Specifica l'altezza, in pixel, del cursore.
pvANDplane
Puntatore a una matrice di byte che contiene i valori di bit per la maschera di bit e del cursore, come in una bitmap monocromatica dipendenti dal dispositivo.
pvXORplane
Puntatore a una matrice di byte che contiene i valori di bit per la maschera di bit XOR del cursore, come in una bitmap monocromatica dipendenti dal dispositivo.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito identifica il cursore.

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

Osservazioni

I parametri nWidth e nHeight necessario specificare una larghezza e un'altezza che sono supportate dal driver di visualizzazione corrente, perché il sistema non è possibile creare cursori di altre dimensioni. Per determinare la larghezza e l'altezza supportate dal driver visualizzazione, utilizzare la funzione GetSystemMetrics , specificando il valore SM_CXCURSOR o SM_CYCURSOR.

Prima della chiusura, un'applicazione deve chiamare la funzione DestroyCursor per liberare le eventuali risorse sistema connesse con il cursore.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di cursori, funzioni di cursore, CreateIcon, DestroyCursor, GetModuleHandle, GetSystemMetrics, SetCursor

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index