Fungsi CreateIconFromResource (winuser.h)

Artikel
03/04/2024

Membuat ikon atau kursor dari bit sumber daya yang menjelaskan ikon.

Untuk menentukan tinggi atau lebar yang diinginkan, gunakan fungsi CreateIconFromResourceEx .

Sintaks

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

Parameter

[in] presbits

Jenis: PBYTE

Penunjuk buffer yang selaras dengan DWORD yang berisi ikon atau bit sumber daya kursor. Bit ini biasanya dimuat oleh panggilan ke fungsi LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx, dan LoadResource .

Lihat Kursor dan Sumber Daya Ikon untuk informasi selengkapnya tentang ikon dan format sumber daya kursor.

[in] dwResSize

Jenis: DWORD

Ukuran, dalam byte, dari sekumpulan bit yang ditujukkan oleh parameter presbit.

[in] fIcon

Jenis: BOOL

Menunjukkan apakah ikon atau kursor akan dibuat. Jika parameter ini TRUE, ikon akan dibuat. Jika FALSE, kursor akan dibuat.

Struktur LOCALHEADER mendefinisikan hotspot kursor dan merupakan data pertama yang dibaca dari bit sumber daya kursor.

[in] dwVer

Jenis: DWORD

Nomor versi ikon atau format kursor untuk bit sumber daya yang ditujukan oleh parameter presbit . Nilai harus lebih besar dari atau sama dengan 0x00020000 dan kurang dari atau sama dengan 0x00030000. Parameter ini umumnya diatur ke 0x00030000.

Nilai kembali

Jenis: HICON

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke ikon atau kursor.

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

Keterangan

Fungsi CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory, dan LookupIconIdFromDirectoryEx memungkinkan aplikasi shell dan browser ikon untuk memeriksa dan menggunakan sumber daya di seluruh sistem.

Fungsi CreateIconFromResource memanggil CreateIconFromResourceEx melewati LR_DEFAULTSIZE|LR_SHARED sebagai bendera.

Anda harus memanggil DestroyIcon untuk ikon atau DestroyCursor untuk kursor yang dibuat dengan CreateIconFromResource.

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