Condividi tramite


Funzione LoadCursorFromFileA (winuser.h)

Crea un cursore basato sui dati contenuti in un file.

Nota

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

Sintassi

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

Parametri

[in] lpFileName

Tipo: LPCTSTR

Origine dei dati del file da utilizzare per creare il cursore. I dati nel file devono trovarsi in . CUR o . Formato ANI.

Se la parola dell'ordine elevato di lpFileName è diverso da zero, si tratta di un puntatore a una stringa che rappresenta un nome completo di un file contenente i dati del cursore.

Valore restituito

Tipo: HCURSOR

Se la funzione ha esito positivo, il valore restituito è un handle per il nuovo cursore.

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

Codice restituito Descrizione
ERROR_FILE_NOT_FOUND
Impossibile trovare il file specificato.

Osservazioni

Virtualizzazione DPI

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

Nota

L'intestazione winuser.h definisce LoadCursorFromFile 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

Vedere anche

concettuale

cursori

LoadCursor

riferimento

SetCursor

SetSystemCursor