Funzione CreateIconFromResource (winuser.h)
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 |
Vedi anche
Informazioni concettuali
Riferimento