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 :

Valeur Signification
CMB_MASKED
Utilise une bitmap comme masque.

[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

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête commctrl.h
Bibliothèque Comctl32.lib
DLL Comctl32.dll
Ensemble d’API ext-ms-win-shell-comctl32-init-l1-1-1 (introduit dans Windows 10, version 10.0.14393)