CreateIcon, fonction (winuser.h)
Crée une icône qui a la taille, les couleurs et les modèles de bits spécifiés.
Pour créer une icône de couleur au moment de l’exécution, vous pouvez utiliser la fonction CreateIconIndirect , qui crée une icône en fonction du contenu d’une structure ICONINFO .
Syntaxe
HICON CreateIcon(
[in, optional] HINSTANCE hInstance,
[in] int nWidth,
[in] int nHeight,
[in] BYTE cPlanes,
[in] BYTE cBitsPixel,
[in] const BYTE *lpbANDbits,
[in] const BYTE *lpbXORbits
);
Paramètres
[in, optional] hInstance
Type : HINSTANCE
Handle du instance du module qui crée l’icône.
[in] nWidth
Type : int
Largeur, en pixels, de l'icône. Consultez la section Remarques.
[in] nHeight
Type : int
Hauteur, en pixels, de l'icône. Consultez la section Remarques.
[in] cPlanes
Type : BYTE
Nombre de plans dans le masque de bits XOR de l’icône. Consultez la section Remarques.
[in] cBitsPixel
Type : BYTE
Nombre de bits par pixel dans le masque de bits XOR de l’icône.
[in] lpbANDbits
Type : const BYTE*
Tableau d’octets qui contient les valeurs de bits pour le masque de bits AND de l’icône. Ce masque de bits décrit une bitmap monochrome. Consultez la section Remarques.
[in] lpbXORbits
Type : const BYTE*
Tableau d’octets qui contient les valeurs de bits du masque de bits XOR de l’icône. Ce masque de bits décrit une image bitmap monochrome ou de couleur. Consultez la section Remarques.
Valeur retournée
Type : HICON
Si la fonction réussit, la valeur de retour est un handle vers une icône.
Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Pour déterminer la taille nominale de l’icône, utilisez la fonction GetSystemMetrics , en spécifiant la valeur SM_CXICON ou SM_CYICON . Vous pouvez également utiliser la version prenant en charge les ppp de cette API, consultez (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Pour plus d’informations, consultez Tailles d’icônes et Développement d’applications de bureau à haute résolution sur Windows.
Pour plus d’informations sur les paramètres lpbANDbits et lpbXORbits , consultez la description du paramètre lpBits de la fonction CreateBitmap .
En cas d’icône monochrome , CreateIcon applique la table de vérité suivante aux masques de bits AND et XOR :
| MASQUE DE BITS AND | Masque de bits XOR | Affichage |
|---|---|---|
| 0 | 0 | Noir |
| 0 | 1 | White |
| 1 | 0 | Screen |
| 1 | 1 | Écran inverse |
Lorsque vous avez terminé d’utiliser l’icône, détruisez-la à l’aide de la fonction DestroyIcon .
Exemples
Pour obtenir un exemple, consultez Création d’une 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 |