Funzione CreateIconFromResource (winuser.h)

Articolo
02/01/2024

Crea un'icona o un cursore da bit di risorsa che descrivono l'icona.

Per specificare un'altezza o una larghezza desiderata, usare la funzione CreateIconFromResourceEx .

Sintassi

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

Parametri

[in] presbits

Tipo: PBYTE

Puntatore del buffer allineato AWORD contenente i bit di risorsa icona o cursore. Questi bit vengono in genere caricati dalle chiamate alle funzioni LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx e LoadResource.

Per altre informazioni su icona e formato risorsa cursore, vedere Cursor e Icon Resources (Risorse cursore e cursore).

[in] dwResSize

Tipo: DWORD

Dimensioni, in byte, del set di bit a cui punta il parametro presbits .

[in] fIcon

Tipo: BOOL

Indica se è necessario creare un'icona o un cursore. Se questo parametro è TRUE, verrà creata un'icona. Se è FALSE, deve essere creato un cursore.

La struttura LOCALHEADER definisce l'hotspot del cursore ed è la prima lettura dei dati dai bit di risorsa del cursore.

[in] dwVer

Tipo: DWORD

Numero di versione del formato dell'icona o del cursore per i bit di risorsa a cui punta il parametro presbits . Il valore deve essere maggiore o uguale a 0x00020000 e minore o uguale a 0x00030000. Questo parametro è in genere impostato su 0x00030000.

Valore restituito

Tipo: HICON

Se la funzione ha esito positivo, il valore restituito è un handle per l'icona o il cursore.

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

Commenti

Le funzioni CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory e LookupIconIdFromDirectoryEx consentono ai browser della shell di esaminare e usare le risorse in tutto il sistema.

La funzione CreateIconFromResource chiama CreateIconFromResourceEx passando LR_DEFAULTSIZE|LR_SHARED come flag.

È necessario chiamare DestroyIcon per le icone o DestroyCursor per i cursori creati con CreateIconFromResource.

Requisiti

Requisito	Valore
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