Функция CreateMappedBitmap (commctrl.h)

  • Статья

Создает растровое изображение для использования на панели инструментов.

Синтаксис

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

Параметры

hInstance

Тип: HINSTANCE

Выполните обработку экземпляра модуля с помощью исполняемого файла, содержащего ресурс растрового изображения.

idBitmap

Тип: INT_PTR

Идентификатор ресурса растрового изображения.

wFlags

Тип: UINT

Флаг растрового изображения. Этот параметр может быть равен нулю или следующему значению:

Значение Значение
CMB_MASKED
 Использует точечный рисунок в качестве маски.

[in] lpColorMap

Тип: LPCOLORMAP

Указатель на структуру COLORMAP , содержащую сведения о цвете, необходимые для сопоставления растровых изображений. Если этот параметр имеет значение NULL, функция использует цветовую карту по умолчанию.

iNumMaps

Тип: int

Количество цветовых карт, на которые указывает lpColorMap.

Возвращаемое значение

Тип: HBITMAP

Возвращает дескриптор для растрового изображения в случае успешного выполнения или значение NULL в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Функция создает новое растровое изображение с использованием данных и цветов, заданных ресурсом растрового изображения, и сведениями о сопоставлении цветов.

Эта функция полностью поддерживается только для изображений с цветными картами; то есть изображения с 256 цветами или меньше.

Примеры

Следующий пример кода создает растровое изображение из ресурса и делает черный цвет прозрачным, сопоставляя его с системным цветом для лица кнопки.

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header commctrl.h
Библиотека Comctl32.lib
DLL Comctl32.dll
Набор API ext-ms-win-shell-comctl32-init-l1-1-1 (представлено в Windows 10, версия 10.0.14393)