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 :

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

Voir aussi

CreateIconIndirect

Icônes

Tailles d’icône