CreateMappedBitmap-Funktion (commctrl.h)

Artikel
03/04/2024

Erstellt eine Bitmap zur Verwendung in einer Symbolleiste.

Syntax

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

Parameter

hInstance

Typ: HINSTANCE

Behandeln Sie das Modul instance mit der ausführbaren Datei, die die Bitmapressource enthält.

idBitmap

Typ: INT_PTR

Ressourcenbezeichner der Bitmapressource.

wFlags

Typ: UINT

Bitmapflag. Dieser Parameter kann null oder der folgende Wert sein:

Wert	Bedeutung
CMB_MASKED	Verwendet eine Bitmap als Maske.

[in] lpColorMap

Typ: LPCOLORMAP

Zeiger auf eine COLORMAP-Struktur , die die Farbinformationen enthält, die zum Zuordnen der Bitmaps erforderlich sind. Wenn dieser Parameter NULL ist, verwendet die Funktion die Standardfarbzuordnung.

iNumMaps

Typ: int

Anzahl der Farbzuordnungen, auf die von lpColorMap verwiesen wird.

Rückgabewert

Typ: HBITMAP

Gibt bei erfolgreicher Ausführung das Handle an die Bitmap zurück, andernfalls NULL . Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Die Funktion erstellt eine neue Bitmap mit den Bitmapdaten und Farben, die durch die Bitmapressource und die Farbzuordnungsinformationen angegeben sind.

Diese Funktion wird nur für Bilder mit Farbzuordnungen vollständig unterstützt. d. h. Bilder mit 256 oder weniger Farben.

Beispiele

Der folgende Beispielcode erstellt eine Bitmap aus einer Ressource und sorgt dafür, dass die Farbe schwarz transparent erscheint, indem sie der Systemfarbe für eine Schaltflächenfläche zugeordnet wird.

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);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll
APIs	ext-ms-win-shell-comctl32-init-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)

Freigeben über