TB_ADDBITMAP pesan

Artikel
06/13/2023

Menambahkan satu atau beberapa gambar ke daftar gambar tombol yang tersedia untuk toolbar.

Parameter

wParam: Jumlah gambar tombol dalam bitmap. Jika lParam menentukan bitmap yang ditentukan sistem, parameter ini diabaikan.
lParam: Penunjuk ke struktur TBADDBITMAP yang berisi pengidentifikasi sumber daya bitmap dan handel ke instans modul dengan file yang dapat dieksekusi yang berisi sumber daya bitmap.

Nilai kembali

Mengembalikan indeks gambar baru pertama jika berhasil, atau -1 jika tidak.

Keterangan

Jika toolbar dibuat menggunakan fungsi CreateWindowEx , Anda harus mengirim pesan TB_BUTTONSTRUCTSIZE ke toolbar sebelum mengirim TB_ADDBITMAP.

Contoh

Contoh berikut membuat bitmap dari sumber daya (IDB_BITMAP1), memetakan warna latar belakang (hitam dalam hal ini) ke warna wajah tombol sistem, dan menambahkannya ke toolbar.

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);
TBADDBITMAP tb;
tb.hInst = NULL;
tb.nID = (UINT_PTR)hbm;

// hWndToolbar is the window handle of the toolbar.
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was 
// created by using CreateWindowEx.
int index = SendMessage (hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tb);

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Commctrl.h