CreateMappedBitmap, fonction (commctrl.h)

Crée une bitmap à utiliser dans une barre d’outils.

Syntaxe

HBITMAP CreateMappedBitmap(
       HINSTANCE  hInstance,
       INT_PTR    idBitmap,
       UINT       wFlags,
  [in] LPCOLORMAP lpColorMap,
       int        iNumMaps
);

Paramètres

hInstance

Type : HINSTANCE

Gérez le module instance avec le fichier exécutable qui contient la ressource bitmap.

idBitmap

Type : INT_PTR

Identificateur de ressource de la ressource bitmap.

wFlags

Type : UINT

Indicateur bitmap. Ce paramètre peut être égal à zéro ou à la valeur suivante :

[in] lpColorMap

Type : LPCOLORMAP

Pointeur vers une structure COLORMAP qui contient les informations de couleur nécessaires pour mapper les bitmaps. Si ce paramètre a la valeur NULL, la fonction utilise la carte de couleurs par défaut.

iNumMaps

Type : int

Nombre de cartes de couleurs pointées par lpColorMap.

Valeur retournée

Type : HBITMAP

Retourne le handle à la bitmap en cas de réussite, ou NULL dans le cas contraire. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

La fonction crée une image bitmap à l’aide des données et des couleurs bitmap spécifiées par la ressource bitmap et des informations de mappage de couleurs.

Cette fonction est entièrement prise en charge uniquement pour les images avec des cartes de couleurs ; c’est-à-dire des images avec 256 couleurs ou moins.

Exemples

L’exemple de code suivant crée une bitmap à partir d’une ressource et rend la couleur noire transparente en la mappant à la couleur système d’une face de bouton.

DWORD backgroundColor = GetSysColor(COLOR_BTNFACE);
COLORMAP colorMap;
colorMap.from = RGB(0, 0, 0);
colorMap.to = backgroundColor;
HBITMAP hbm = CreateMappedBitmap(g_hInst, IDB_BITMAP1, 0, &colorMap, 1);

Configuration requise