CreateIconFromResourceEx, fonction (winuser.h)

Article
02/01/2024

Crée une icône ou un curseur à partir de bits de ressource décrivant l’icône.

Syntaxe

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

Paramètres

[in] presbits

Type : PBYTE

Pointeur de mémoire tampon aligné sur DWORD contenant les bits de ressource de l’icône (RT_ICON) ou du curseur (RT_CURSOR). Ces bits sont généralement chargés par des appels aux fonctions LookupIconIdFromDirectoryEx et LoadResource .

Pour plus d’informations sur le format des icônes et des icônes, consultez Curseur et Ressources d’icône.

[in] dwResSize

Type : DWORD

Taille, en octets, du jeu de bits vers lequel pointe le paramètre pbIconBits .

[in] fIcon

Type : BOOL

Indique si une icône ou un curseur doit être créé. Si ce paramètre a la valeur TRUE, une icône doit être créée. S’il est FALSE, un curseur doit être créé.

La structure LOCALHEADER définit le point d’accès du curseur et est la première lecture de données à partir des bits de ressource du curseur.

[in] dwVer

Type : DWORD

Numéro de version du format d’icône ou de curseur pour les bits de ressource pointés par le paramètre presbits . La valeur doit être supérieure ou égale à 0x00020000 et inférieure ou égale à 0x00030000. Ce paramètre est généralement défini sur 0x00030000.

[in] cxDesired

Type : int

Largeur, en pixels, de l’icône ou du curseur. Si ce paramètre est égal à zéro et que le paramètre Flags est LR_DEFAULTSIZE, la fonction utilise la valeur de métrique système SM_CXICON ou SM_CXCURSOR pour définir la largeur. Si ce paramètre est égal à zéro et que LR_DEFAULTSIZE n’est pas utilisé, la fonction utilise la largeur de ressource réelle.

[in] cyDesired

Type : int

Hauteur, en pixels, de l’icône ou du curseur. Si ce paramètre est égal à zéro et que le paramètre Flags est LR_DEFAULTSIZE, la fonction utilise la valeur de métrique système SM_CYICON ou SM_CYCURSOR pour définir la hauteur. Si ce paramètre est égal à zéro et que LR_DEFAULTSIZE n’est pas utilisé, la fonction utilise la hauteur de ressource réelle.

[in] Flags

Type : UINT

Combinaison des valeurs suivantes.

Valeur	Signification
LR_DEFAULTCOLOR 0x00000000	Utilise le format de couleur par défaut.
LR_DEFAULTSIZE 0x00000040	Utilise la largeur ou la hauteur spécifiées par les valeurs de métrique système pour les curseurs ou les icônes, si les valeurs cxDesired ou cyDesired sont définies sur zéro. Si cet indicateur n’est pas spécifié et que cxDesired et cyDesired sont définis sur zéro, la fonction utilise la taille de ressource réelle.
LR_MONOCHROME 0x00000001	Crée une icône ou un curseur monochrome.
LR_SHARED 0x00008000	Partage l’icône ou le handle du curseur si l’icône ou le curseur est créé plusieurs fois. Si LR_SHARED n’est pas défini, un deuxième appel à CreateIconFromResourceEx pour la même ressource crée à nouveau l’icône ou le curseur et retourne un autre handle. Lorsque vous utilisez cet indicateur, le système détruit la ressource lorsqu’elle n’est plus nécessaire. N’utilisez pas LR_SHARED pour les icônes ou les curseurs qui ont des tailles non standard, qui peuvent changer après le chargement ou qui sont chargés à partir d’un fichier.

Valeur retournée

Type : HICON

Si la fonction réussit, la valeur de retour est un handle vers l’icône ou le curseur.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Les fonctions CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo et LookupIconIdFromDirectoryEx permettent aux applications shell et aux navigateurs d’icônes d’examiner et d’utiliser des ressources dans tout le système.

Vous devez appeler DestroyIcon pour les icônes ou DestroyCursor pour les curseurs créés avec CreateIconFromResourceEx.

Exemples

Pour obtenir un exemple, consultez Partage des ressources d’icône.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll