Funzione LoadCursorA (winuser.h)

Articolo
08/27/2023

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

Nota

Questa funzione è stata sostituita dalla funzione LoadImage (con LR_DEFAULTSIZE e LR_SHARED flag 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 è diverso da 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 per il cursore appena caricato.

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

Commenti

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.

Esempio

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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