Funzione LoadCursorA (winuser.h)

Articolo
11/20/2024

Carica la risorsa cursore specificata dal file eseguibile (.EXE) associato a un'istanza dell'applicazione.

Nota

Questa funzione è stata sostituita dalla funzione LoadImage (con flag LR_DEFAULTSIZE e LR_SHARED impostati).

Sintassi

HCURSOR LoadCursorA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpCursorName
);

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle per il modulo di un file DLL o eseguibile (.exe) che contiene il cursore da caricare. Per altre informazioni, vedere GetModuleHandle.

Per caricare un cursore di sistema predefinito, impostare questo parametro su NULL.

[in] lpCursorName

Tipo: LPCTSTR

Se hInstance non èNULL, lpCursorName specifica la risorsa cursore in base al nome o all'ordinale. Questo ordinale deve essere creato in un pacchetto utilizzando la macro MAKEINTRESOURCE.

Se hInstance è NULL, lpCursorName specifica l'identificatore (a partire dal prefisso IDC_) di un cursore di sistema predefinito da caricare.

Valore restituito

Tipo: HCURSOR

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

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

Osservazioni

La funzione LoadCursor carica la risorsa cursore solo se non è stata caricata; in caso contrario, recupera l'handle nella risorsa esistente. Questa funzione restituisce un handle di cursore valido solo se il parametro lpCursorName è un puntatore a una risorsa cursore. Se lpCursorName è un puntatore a qualsiasi tipo di risorsa diverso da un cursore (ad esempio un'icona), il valore restituito non è NULL, anche se non è un handle di cursore valido.

La funzione LoadCursor cerca la risorsa cursore più appropriata per il cursore per il dispositivo di visualizzazione corrente. La risorsa cursore può essere un colore o una bitmap monocromatica.

Virtualizzazione DPI

Questa API non partecipa alla virtualizzazione DPI. L'output restituito non è interessato dal valore DPI del thread chiamante.

Esempi

Per un esempio, vedere Creazione di un cursore.

Nota

L'intestazione winuser.h definisce LoadCursor come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

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