Funzione CreateIconFromResourceEx (winuser.h)

Articolo
11/20/2024

Crea un'icona o un cursore dai bit delle risorse 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 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.

Vedi Risorse cursore e icona per altre informazioni sul formato icona e risorsa cursore.

[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 è la prima lettura dei dati dai bit delle risorse del cursore.

[in] dwVer

Tipo: DWORD

Numero di versione dell'icona o del formato del cursore per i bit di risorsa a cui punta il parametro presbit. 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 flag è LR_DEFAULTSIZE, la funzione usa il valore della metrica di sistema SM_CXICON o SM_CXCURSOR per impostare la larghezza. Se questo parametro è zero e LR_DEFAULTSIZE non viene usato, 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 flag è LR_DEFAULTSIZE, la funzione usa il valore SM_CYICON o SM_CYCURSOR metrica di sistema 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 i valori cyDesired sono impostati su zero. Se questo flag non viene specificato e cxDesired e cyDesired vengono 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 caricate 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Le CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfoe LookupIconIdFromDirectoryEx consentono alle applicazioni shell e ai browser delle icone di esaminare e usare risorse in tutto il sistema.

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

Esempi

Per un esempio, vedere condivisione delle risorse icona.

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