fungsi ImageList_LoadImageA (commctrl.h)
Membuat daftar gambar dari bitmap yang ditentukan.
Sintaks
HIMAGELIST ImageList_LoadImageA(
HINSTANCE hi,
LPCSTR lpbmp,
int cx,
int cGrow,
COLORREF crMask,
UINT uType,
UINT uFlags
);
Parameter
hi
Jenis: HINSTANCE
Handel ke instans yang berisi sumber daya. Parameter ini dapat berupa NULL jika Anda memuat gambar dari file atau memuat sumber daya OEM.
lpbmp
Jenis: LPCTSTR
Gambar yang akan dimuat.
Jika parameter uFlags menyertakan LR_LOADFROMFILE, lpbmp adalah alamat string yang dihentikan null yang memberi nama file yang berisi gambar yang akan dimuat.
Jika parameter hinon-NULL dan LR_LOADFROMFILE tidak ditentukan, lpbmp adalah alamat string yang dihentikan null yang berisi nama sumber daya gambar dalam modul hi .
Jika hiadalah NULL dan LR_LOADFROMFILE tidak ditentukan, LOWORD parameter ini harus menjadi pengidentifikasi gambar OEM untuk dimuat. Untuk membuat nilai ini, gunakan makro MAKEINTRESOURCE dengan salah satu pengidentifikasi gambar OEM yang ditentukan dalam Winuser.h. Pengidentifikasi ini memiliki awalan berikut.
Nilai | Makna |
---|---|
|
|
|
|
|
cx
Jenis: int
Lebar setiap gambar. Tinggi setiap gambar dan jumlah awal gambar disimpulkan oleh dimensi sumber daya yang ditentukan.
cGrow
Jenis: int
Jumlah gambar di mana daftar gambar dapat bertambah 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, kursor, atau ikon 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. Jika parameter ini adalah nilai CLR_DEFAULT, warna piksel di sudut kiri atas gambar diperlakukan sebagai warna masker.
uType
Jenis: UINT
Bendera yang menentukan jenis gambar yang akan dimuat. Parameter ini harus IMAGE_BITMAP untuk menunjukkan bahwa bitmap sedang dimuat.
Nilai | Makna |
---|---|
|
Memuat bitmap. |
uFlags
Jenis: UINT
Bendera yang menentukan cara memuat gambar. Parameter ini bisa menjadi kombinasi dari nilai berikut.
Nilai kembali
Jenis: HIMAGELIST
Mengembalikan handel ke daftar gambar jika berhasil, atau NULL sebaliknya.
Keterangan
LR_LOADTRANSPARENT tidak memuat gambar secara transparan. Ini membuat daftar gambar buram yang hanya tampak transparan karena semua piksel latar belakang telah diubah menjadi COLOR_WINDOW. Jika gambar digambar di atas latar belakang yang bukan warna COLOR_WINDOW, gambar tidak menggambar dengan benar. Selain itu, LR_LOADTRANSPARENT dan LR_LOADMAP3DCOLORS menggunakan warna sistem yang berlaku pada saat ImageList_LoadImage dipanggil. Jika warna sistem kemudian berubah, aplikasi harus memuat ulang gambar untuk memetakan ulang warna.
Catatan
Header commctrl.h mendefinisikan ImageList_LoadImage sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
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 |