Fungsi CreateMappedBitmap (commctrl.h)

Artikel
02/28/2024

Membuat bitmap untuk digunakan di toolbar.

Sintaks

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

Parameter

hInstance

Jenis: HINSTANCE

Tangani ke instans modul dengan file yang dapat dieksekusi yang berisi sumber daya bitmap.

idBitmap

Jenis: INT_PTR

Pengidentifikasi sumber daya sumber daya bitmap.

wFlags

Jenis: UINT

Bendera bitmap. Parameter ini bisa nol atau nilai berikut:

Nilai	Makna
CMB_MASKED	Menggunakan bitmap sebagai masker.

[in] lpColorMap

Jenis: LPCOLORMAP

Penunjuk ke struktur COLORMAP yang berisi informasi warna yang diperlukan untuk memetakan bitmap. Jika parameter ini NULL, fungsi menggunakan peta warna default.

iNumMaps

Jenis: int

Jumlah peta warna yang ditujukkan oleh lpColorMap.

Mengembalikan nilai

Jenis: HBITMAP

Mengembalikan handel ke bitmap jika berhasil, atau NULL sebaliknya. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Keterangan

Fungsi ini membuat bitmap baru menggunakan data bitmap dan warna yang ditentukan oleh sumber daya bitmap dan informasi pemetaan warna.

Fungsi ini sepenuhnya didukung hanya untuk gambar dengan peta warna; yaitu, gambar dengan 256 atau lebih sedikit warna.

Contoh

Contoh kode berikut membuat bitmap dari sumber daya dan membuat warna hitam tampak transparan dengan memetakannya ke warna sistem untuk wajah tombol.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	commctrl.h
Pustaka	Comctl32.lib
DLL	Comctl32.dll
Set API	ext-ms-win-shell-comctl32-init-l1-1-1 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Bagikan melalui