ImageList_LoadBitmap makro (commctrl.h)

Memanggil fungsi ImageList_LoadImage untuk membuat daftar gambar dari sumber daya bitmap yang ditentukan.

Sintaksis

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

Parameter

hi

Jenis: HINSTANCE

Handel ke instans yang berisi sumber daya bitmap. Parameter ini NULL jika Anda memuat bitmap OEM.

lpbmp

Jenis: LPCTSTR

Gambar yang akan dimuat. Jika parameter hi non-NULL, lpbmp adalah alamat string null-terminated yang berisi nama sumber daya gambar dalam modul hi . Jika hiNULL , LOWORD dari parameter ini harus menjadi pengidentifikasi bitmap OEM untuk dimuat. Untuk membuat nilai ini, gunakan makro MAKEINTRESOURCE dengan salah satu pengidentifikasi bitmap OEM yang ditentukan dalam WINUSER.H. Pengidentifikasi ini memiliki awalan OBM_.

cx

Jenis: int

Lebar setiap gambar. Tinggi setiap gambar dan jumlah awal gambar disimpulkan oleh dimensi bitmap yang ditentukan.

cGrow

Jenis: int

Jumlah gambar di mana daftar gambar dapat tumbuh ketika sistem perlu memberi ruang untuk gambar baru. Parameter ini menunjukkan jumlah gambar baru yang dapat dimuat oleh daftar gambar yang diubah ukurannya.

crMask

Jenis: COLORREF

Warna yang digunakan untuk menghasilkan masker. Setiap piksel warna ini dalam bitmap yang ditentukan diubah menjadi hitam, dan bit yang sesuai dalam masker diatur ke 1. Jika parameter ini adalah nilai CLR_NONE, tidak ada masker yang dihasilkan.

Mengembalikan nilai

Jenis: HIMAGELIST

Mengembalikan handel ke daftar gambar jika berhasil, atau NULL sebaliknya.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h