fungsi ImageList_LoadImageA (commctrl.h)

2024-11-18

Membuat daftar gambar dari bitmap yang ditentukan.

Sintaksis

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 NULL jika Anda memuat gambar dari file atau memuat sumber daya OEM.

lpbmp

Jenis: LPCTSTR

Gambar yang akan dimuat.

Jika parameter uFlags mencakup LR_LOADFROMFILE, lpbmp adalah alamat string null-terminated yang memberi nama file yang berisi gambar yang akan dimuat.

Jika parameter hi non- NULL dan LR_LOADFROMFILE tidak ditentukan, lpbmp adalah alamat string null-terminated yang berisi nama sumber daya gambar dalam modul hi.

Jika hi NULL dan LR_LOADFROMFILE tidak ditentukan, LOWORD dari 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	Arti
OBM_ untuk bitmap OEM
OIC_ untuk ikon OEM
OCR_ untuk kursor OEM

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 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, 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.

CatatanImageList_LoadImage hanya digunakan dengan file bitmap. Tidak ada jenis gambar lain yang didukung.

Nilai	Arti
IMAGE_BITMAP	Memuat bitmap.

uFlags

Jenis: UINT

Bendera yang menentukan cara memuat gambar. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Arti
LR_CREATEDIBSECTION	Menyebabkan fungsi mengembalikan bitmap bagian DIB daripada bitmap yang kompatibel ketika parameter uType menentukan IMAGE_BITMAP. LR_CREATEDIBSECTION berguna untuk memuat bitmap tanpa memetakannya ke warna perangkat tampilan.
LR_DEFAULTCOLOR	Menggunakan format warna tampilan.
LR_DEFAULTSIZE	Menggunakan lebar atau tinggi yang ditentukan oleh nilai metrik sistem untuk kursor dan ikon jika parameter cx diatur ke nol. Jika nilai ini tidak ditentukan dan cx diatur ke nol, fungsi mengatur ukuran ke yang ditentukan dalam sumber daya. Jika sumber daya berisi beberapa gambar, fungsi mengatur ukuran ke gambar pertama.
LR_LOADFROMFILE	Memuat gambar dari file yang ditentukan oleh parameter lpbmp .
LR_LOADMAP3DCOLORS	Mencari tabel warna untuk gambar dan mengganti warna abu-abu berikut dengan warna tiga dimensi yang sesuai: Dk Gray: RGB(128, 128, 128)COLOR_3DSHADOW Abu-abu: RGB(192, 192, 192)COLOR_3DFACE Lt Gray: RGB(223, 223, 223)COLOR_3DLIGHT Untuk informasi selengkapnya, lihat bagian Keterangan.
LR_LOADTRANSPARENT	Mengambil nilai warna piksel pertama dalam gambar dan mengganti entri yang sesuai dalam tabel warna dengan warna jendela default (warna tampilan COLOR_WINDOW). Semua piksel dalam gambar yang menggunakan warna tersebut menjadi warna nilai jendela default. Nilai ini hanya berlaku untuk gambar yang memiliki tabel warna yang sesuai. Untuk informasi selengkapnya, lihat bagian Keterangan.
LR_MONOCHROME	Memuat gambar dalam warna hitam dan putih.
LR_SHARED	Berbagi handel gambar jika gambar dimuat beberapa kali. Jangan gunakan nilai ini untuk gambar yang memiliki ukuran nontradisial yang mungkin berubah setelah memuat atau untuk gambar yang dimuat dari file.

Mengembalikan nilai

Jenis: HIMAGELIST

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

Komentar

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.

Nota

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

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
Pustaka	Comctl32.lib
DLL	Comctl32.dll

Lihat juga

LoadImage

Bagikan melalui