LoadCursor

La funzione LoadCursor carica la risorsa cursore specificato dall'eseguibile (.File EXE) associato a un'istanza di applicazione.

Questa funzione stata sostituita dalla funzione LoadImage

(HCURSOR LoadCursor HINSTANCE , hInstance, / / handle all'istanza dell'applicazioneLPCTSTRlpCursorName / / nome del cursore o stringa resource identifier);
 

Parametri

hInstance
Gestire a un'istanza del modulo cui file eseguibile contiene il cursore deve essere caricato.
lpCursorName
Puntatore a una stringa null-terminated che contiene il nome della risorsa cursore deve essere caricato. In alternativa, questo parametro pu consistere l'identificatore di risorsa nella parola significativi e zero nella parola significativi. La macro MAKEINTRESOURCE pu anche essere utilizzata per creare questo valore.

Per utilizzare uno dei cursori predefiniti di Win32, l'applicazione deve impostare il hInstance parametro su NULL e il parametro lpCursorName per uno i seguenti valori:
Valore Descrizione
IDC_APPSTARTING Freccia standard e piccola clessidra
IDC_ARROW Freccia standard
IDC_CROSS Mirino
IDC_HAND Windows NT 5.0 e versioni successive: Mano
IDC_HELP Freccia e il punto interrogativo
IDC_IBEAM -Beam
IDC_ICON Obsoleta per applicazioni contrassegnato versione 4.0 o successive.
IDC_NO Cerchio barrato
IDC_SIZE Obsoleto per applicazioni contrassegnato versione 4.0 o successive. Uso IDC_SIZEALL.
IDC_SIZEALL Freccia a quattro punte verso nord, Sud, est e ovest
IDC_SIZENESW A sud-ovest e la freccia a due punte che punta a nord-est
IDC_SIZENS Sud e freccia a due punte verso il nord
IDC_SIZENWSE Sud-est e la freccia a due punte che punta a nord-ovest
IDC_SIZEWE Freccia a due punte verso Occidente e Oriente
IDC_UPARROW Freccia verticale
IDC_WAIT Clessidra

Valori restituiti

Se la funzione ha esito positivo, il valore restituito l'handle per il cursore appena caricato.

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

Osservazioni

La funzione LoadCursor carica la risorsa cursore solo se non stato caricato; in caso contrario, recupera l'handle alla risorsa esistente. Questa funzione restituisce un cursore valido handle, solo se i punti del parametro lpCursorName a una risorsa del cursore. Se lpCursorName punta a qualsiasi tipo di risorsa diversa da un cursore (ad esempio un'icona), il valore restituito non NULL, anche se non un handle valido cursore.

La funzione LoadCursor cerca la risorsa cursore pi appropriata per il cursore per il dispositivo di visualizzazione corrente. La risorsa di cursore pu essere una bitmap a colori o in bianco e nero.

Windows CE: Utilizzare il componente di cursore quando una piattaforma che non supporta cursori del mouse di targeting. Il cursore solo che supporta questo componente il cursore di attesa (IDC_WAIT). Utilizzare la funzione di LoadCursor con la funzione SetCursor per impostare il cursore di attesa.

SetCursor (LoadCursor (NULL, IDC_WAIT))

Utilizzare il componente mcursor quando una piattaforma che supporta cursori del mouse di targeting. Questo componente supporta la funzione di LoadCursor le stesse finestre di modo piattaforme desktop fanno, tranne che supporta solo i cursori monocromatici. Windows CE non supporta cursori di colore. Un tentativo di caricare un cursore colore avr risultati imprevedibili.

Vedi anche

Panoramica di cursori, funzioni di cursore, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

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

Index