Funzione CreateIconFromResourceEx (winuser.h)

Articolo
03/13/2024

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

Sintassi

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parametri

[in] presbits

Tipo: PBYTE

Puntatore al buffer allineato con DWORD contenente i bit di risorsa (RT_ICON) o cursore (RT_CURSOR). Questi bit vengono in genere caricati dalle chiamate alle funzioni LookupIconIdFromDirectoryEx e LoadResource .

Per altre informazioni sull'icona e sul formato di risorsa cursore, vedi Risorse cursore e icona .

[in] dwResSize

Tipo: DWORD

Dimensione, in byte, del set di bit a cui punta il parametro pbIconBits .

[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 è il primo dato letto dai bit delle risorse del cursore.

[in] dwVer

Tipo: DWORD

Numero di versione dell'icona o del formato del cursore per i bit della 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.

[in] cxDesired

Tipo: int

Larghezza, in pixel, dell'icona o del cursore. Se questo parametro è zero e il parametro Flags è LR_DEFAULTSIZE, la funzione usa il SM_CXICON o SM_CXCURSOR valore della metrica di sistema per impostare la larghezza. Se questo parametro è zero e non viene usato LR_DEFAULTSIZE , la funzione usa la larghezza effettiva della risorsa.

[in] cyDesired

Tipo: int

Altezza, in pixel, dell'icona o del cursore. Se questo parametro è zero e il parametro Flags è LR_DEFAULTSIZE, la funzione usa il valore della metrica di sistema SM_CYICON o SM_CYCURSOR per impostare l'altezza. Se questo parametro è zero e non viene usato LR_DEFAULTSIZE , la funzione usa l'altezza effettiva della risorsa.

[in] Flags

Tipo: UINT

Combinazione dei valori seguenti.

Valore	Significato
LR_DEFAULTCOLOR 0x00000000	Usa il formato di colore predefinito.
LR_DEFAULTSIZE 0x00000040	Usa la larghezza o l'altezza specificata dai valori delle metriche di sistema per cursori o icone, se i valori cxDesired o cyDesired sono impostati su zero. Se questo flag non è specificato e cxDesired e cyDesired sono impostati su zero, la funzione usa le dimensioni effettive della risorsa.
LR_MONOCHROME 0x00000001	Crea un'icona o un cursore monocromatico.
LR_SHARED 0x00008000	Condivide l'icona o l'handle di cursore se l'icona o il cursore vengono creati più volte. Se LR_SHARED non è impostato, una seconda chiamata a CreateIconFromResourceEx per la stessa risorsa creerà nuovamente l'icona o il cursore e restituirà un handle diverso. Quando si usa questo flag, il sistema eliminerà la risorsa quando non è più necessaria. Non usare LR_SHARED per icone o cursori con dimensioni non standard, che possono cambiare dopo il caricamento o che vengono caricati da un file.

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 e LookupIconIdFromDirectoryEx consentono alle applicazioni shell e ai browser icona di esaminare e usare le risorse in tutto il sistema.

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

Esempio

Per un esempio, vedere Condivisione delle risorse icona.

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