Fungsi LoadBitmapW (winuser.h)

Artikel
03/04/2024

[LoadBitmap tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan LoadImage dan DrawFrameControl.]

Fungsi LoadBitmap memuat sumber daya bitmap yang ditentukan dari file modul yang dapat dieksekusi.

Sintaks

HBITMAP LoadBitmapW(
  [in] HINSTANCE hInstance,
  [in] LPCWSTR   lpBitmapName
);

Parameter

[in] hInstance

Handel ke instans modul yang file yang dapat dieksekusi berisi bitmap yang akan dimuat.

[in] lpBitmapName

Penunjuk ke string yang dihentikan null yang berisi nama sumber daya bitmap yang akan dimuat. Atau, parameter ini dapat terdiri dari pengidentifikasi sumber daya dalam kata urutan rendah dan nol dalam kata urutan tinggi. Makro MAKEINTRESOURCE dapat digunakan untuk membuat nilai ini.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke bitmap yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Jika bitmap yang diacu oleh parameter lpBitmapName tidak ada atau memori tidak mencukupi untuk memuat bitmap, fungsi gagal.

LoadBitmap membuat bitmap tampilan yang kompatibel, yang tidak dapat dipilih ke printer. Untuk memuat bitmap yang dapat Anda pilih ke printer, panggil LoadImage dan tentukan LR_CREATEDIBSECTION untuk membuat bagian DIB. Bagian DIB dapat dipilih ke perangkat apa pun.

Aplikasi dapat menggunakan fungsi LoadBitmap untuk mengakses bitmap yang telah ditentukan sebelumnya. Untuk melakukannya, aplikasi harus mengatur parameter hInstance ke NULL dan parameter lpBitmapName ke salah satu nilai berikut.

Nama bitmap	Nama bitmap
OBM_BTNCORNERS	OBM_OLD_RESTORE
OBM_BTSIZE	OBM_OLD_RGARROW
OBM_CHECK	OBM_OLD_UPARROW
OBM_CHECKBOXES	OBM_OLD_ZOOM
OBM_CLOSE	OBM_REDUCE
OBM_COMBO	OBM_REDUCED
OBM_DNARROW	OBM_RESTORE
OBM_DNARROWD	OBM_RESTORED
OBM_DNARROWI	OBM_RGARROW
OBM_LFARROW	OBM_RGARROWD
OBM_LFARROWD	OBM_RGARROWI
OBM_LFARROWI	OBM_SIZE
OBM_MNARROW	OBM_UPARROW
OBM_OLD_CLOSE	OBM_UPARROWD
OBM_OLD_DNARROW	OBM_UPARROWI
OBM_OLD_LFARROW	OBM_ZOOM
OBM_OLD_REDUCE	OBM_ZOOMD

Nama bitmap yang dimulai dengan OBM_OLD mewakili bitmap yang digunakan oleh Windows versi 16-bit yang lebih lama dari 3.0.

Agar aplikasi menggunakan salah satu konstanta OBM_, OEMRESOURCE konstanta harus ditentukan sebelum file header Windows.h disertakan.

Aplikasi harus memanggil fungsi DeleteObject untuk menghapus setiap handel bitmap yang dikembalikan oleh fungsi LoadBitmap .

Contoh

Misalnya, lihat Contoh bitmap Menu-Item di Menggunakan Menu.

Catatan

Header winuser.h mendefinisikan LoadBitmap 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-draw-l1-1-1 (diperkenalkan dalam Windows 8.1)