CreateIconFromResource, fonction (winuser.h)

Article
01/27/2024

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

Pour spécifier une hauteur ou une largeur souhaitée, utilisez la fonction CreateIconFromResourceEx .

Syntaxe

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

Paramètres

[in] presbits

Type : PBYTE

Pointeur de mémoire tampon aligné sur DWORD contenant les bits de ressource d’icône ou de curseur. Ces bits sont généralement chargés par des appels aux fonctions LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx et LoadResource .

Pour plus d’informations sur le format de ressource d’icône et d’icône, consultez Ressources de curseur et de curseur.

[in] dwResSize

Type : DWORD

Taille, en octets, de l’ensemble de bits vers lequel pointe le paramètre presbits .

[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 a la valeur FALSE, un curseur doit être créé.

La structure LOCALHEADER définit le point d’accès du curseur et est la première donnée lue à 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.

Valeur retournée

Type : HICON

Si la fonction réussit, la valeur de retour est un handle pour 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, LookupIconIdFromDirectory et LookupIconIdFromDirectoryEx permettent aux applications shell et aux navigateurs d’icônes d’examiner et d’utiliser des ressources dans l’ensemble du système.

La fonction CreateIconFromResource appelle CreateIconFromResourceEx en passant LR_DEFAULTSIZE|LR_SHARED en tant qu’indicateurs.

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

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