CreateIconFromResourceEx, fonction (winuser.h)

Article
11/20/2024

Crée une icône ou un curseur à partir de bits de ressources 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 ressources d’icône et de curseur, consultez Ressources de curseur et de curseur.

[in] dwResSize

Type : DWORD

Taille, en octets, de l’ensemble de bits pointés par le paramètre pbIconBits.

[in] fIcon

Type : BOOL

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

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

[in] dwVer

Type : DWORD

Numéro de version de l’icône ou du format de curseur pour les bits de ressource pointés par les prébits paramètre. 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 indicateurs de 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 réelle des ressources.

[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 indicateurs de 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 réelle de la ressource.
LR_MONOCHROME 0x00000001	Crée une icône ou un curseur monochrome.
LR_SHARED 0x00008000	Partage l’icône ou la poignée de 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 handle différent. 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 de retour

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’erreur étendues, appelez GetLastError.

Remarques

Les CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfoet 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 ressources d’icône de partage.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll