CreateMappedBitmap, fonction (commctrl.h)

Article
08/22/2023

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)

Partager via