Fungsi LoadImageA (winuser.h)

Memuat ikon, kursor, kursor animasi, atau bitmap.

Sintaksis

HANDLE LoadImageA(
  [in, optional] HINSTANCE hInst,
  [in]           LPCSTR    name,
  [in]           UINT      type,
  [in]           int       cx,
  [in]           int       cy,
  [in]           UINT      fuLoad
);

Parameter

[in, optional] hInst

Jenis: HINSTANCE

Handel ke modul DLL atau yang dapat dieksekusi (.exe) yang berisi gambar yang akan dimuat. Untuk informasi selengkapnya, lihat GetModuleHandle. Perhatikan bahwa pada Windows 32-bit, handel instans (HINSTANCE), seperti handel instans aplikasi yang diekspos oleh panggilan fungsi sistem WinMain, dan handel modul (HMODULE) adalah hal yang sama.

Untuk memuat gambar yang telah ditentukan sebelumnya atau sumber daya mandiri (ikon, kursor, atau file bitmap), atur parameter ini ke NULL.

[in] name

Jenis: LPCTSTR

Gambar yang akan dimuat.

Jika parameter hInst tidak NULL dan parameter fuLoad menghilangkan LR_LOADFROMFILE, nama menentukan sumber daya gambar dalam modul hInst.

Jika sumber daya gambar akan dimuat berdasarkan nama dari modul, nama parameter adalah penunjuk ke string yang dihentikan null yang berisi nama sumber daya gambar.

Jika sumber daya gambar akan dimuat secara ordinal dari modul, gunakan makro MAKEINTRESOURCE untuk mengonversi gambar ordinal menjadi formulir yang dapat diteruskan ke fungsi LoadImage.

Jika parameter hInst NULL dan parameter fuLoad menghilangkan nilai LR_LOADFROMFILE dan menyertakan LR_SHARED, nama menentukan gambar yang telah ditentukan sebelumnya untuk dimuat.

Pengidentifikasi gambar yang telah ditentukan sebelumnya ditentukan dalam Winuser.h dan memiliki awalan berikut:

Untuk meneruskan konstanta pengidentifikasi gambar OEM ke fungsi LoadImage , gunakan makro MAKEINTRESOURCE. Misalnya, untuk memuat kursor OCR_NORMAL, teruskan sebagai parameter nama , NULL sebagai parameter hInst, dan LR_SHARED sebagai salah satu bendera ke parameter fuLoad .

Jika parameter hInst NULL dan parameter fuLoad mencakup nilai LR_LOADFROMFILE, nama adalah nama file yang berisi sumber daya mandiri (ikon, kursor, atau file bitmap), - misalnya, .

Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

[in] type

Jenis: UINT

Jenis gambar yang akan dimuat.

Parameter ini bisa menjadi salah satu nilai berikut:

[in] cx

Jenis: int

Lebar, dalam piksel, ikon atau kursor. Jika parameter ini nol dan parameter fuLoad LR_DEFAULTSIZE, fungsi menggunakan nilai metrik sistem SM_CXICON atau SM_CXCURSOR untuk mengatur lebar. Jika parameter ini nol dan LR_DEFAULTSIZE tidak digunakan, fungsi menggunakan lebar sumber daya aktual.

[in] cy

Jenis: int

Tinggi, dalam piksel, ikon atau kursor. Jika parameter ini nol dan parameter fuLoad LR_DEFAULTSIZE, fungsi menggunakan nilai metrik sistem SM_CYICON atau SM_CYCURSOR untuk mengatur tinggi. Jika parameter ini nol dan LR_DEFAULTSIZE tidak digunakan, fungsi menggunakan tinggi sumber daya aktual.

[in] fuLoad

Jenis: UINT

Parameter ini bisa berupa satu atau beberapa nilai berikut.

Mengembalikan nilai

Jenis: HANDLE

Jika fungsi berhasil, nilai pengembalian adalah handel gambar yang baru dimuat.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Jika IS_INTRESOURCE( nama) TRUE, maka nama menentukan pengidentifikasi bilangan bulat dari sumber daya yang diberikan. Jika tidak, ini adalah penunjuk ke string yang dihentikan null. Jika karakter pertama string adalah tanda pound (#), maka karakter yang tersisa mewakili angka desimal yang menentukan pengidentifikasi bilangan bulat sumber daya. Misalnya, string "#258" mewakili pengidentifikasi 258.

Setelah selesai menggunakan bitmap, kursor, atau ikon yang Anda muat tanpa menentukan bendera LR_SHARED, Anda dapat merilis memori terkait dengan memanggil salah satu fungsi dalam tabel berikut.

Sistem secara otomatis menghapus sumber daya ini ketika proses yang membuatnya berakhir; namun, memanggil fungsi yang sesuai akan menghemat memori dan mengurangi ukuran set kerja proses.

Contoh

Misalnya, lihat Menggunakan Kelas Jendela.

Persyaratan

Lihat juga

Konseptual

CopyImage

GetSystemMetrics

LoadBitmap

LoadCursor

LoadIcon

Sumber Daya Lain

Referensi

Sumber Daya