Fungsi CreateIconFromResourceEx (winuser.h)

Artikel
02/01/2024

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

Sintaks

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parameter

[in] presbits

Jenis: PBYTE

Penunjuk buffer yang selaras dengan DWORD yang berisi bit sumber daya ikon (RT_ICON) atau kursor (RT_CURSOR). Bit ini biasanya dimuat oleh panggilan ke fungsi 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 set bit yang ditujukkan oleh parameter pbIconBits .

[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 ditujukkan 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.

[in] cxDesired

Jenis: int

Lebar, dalam piksel, ikon atau kursor. Jika parameter ini nol dan parameter BenderaLR_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] cyDesired

Jenis: int

Tinggi, dalam piksel, ikon atau kursor. Jika parameter ini nol dan parameter BenderaLR_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] Flags

Jenis: UINT

Kombinasi nilai berikut.

Nilai	Makna
LR_DEFAULTCOLOR 0x00000000	Menggunakan format warna default.
LR_DEFAULTSIZE 0x00000040	Menggunakan lebar atau tinggi yang ditentukan oleh nilai metrik sistem untuk kursor atau ikon, jika nilai cxDesired atau cyDesired diatur ke nol. Jika bendera ini tidak ditentukan dan cxDesired dan cyDesired diatur ke nol, fungsi menggunakan ukuran sumber daya aktual.
LR_MONOCHROME 0x00000001	Membuat ikon atau kursor monokrom.
LR_SHARED 0x00008000	Berbagi ikon atau handel kursor jika ikon atau kursor dibuat beberapa kali. Jika LR_SHARED tidak diatur, panggilan kedua ke CreateIconFromResourceEx untuk sumber daya yang sama akan membuat ikon atau kursor lagi dan mengembalikan handel yang berbeda. Ketika Anda menggunakan bendera ini, sistem akan menghancurkan sumber daya ketika tidak lagi diperlukan. Jangan gunakan LR_SHARED untuk ikon atau kursor yang memiliki ukuran non-standar, yang dapat berubah setelah memuat, atau yang dimuat dari file.

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, dan LookupIconIdFromDirectoryEx memungkinkan aplikasi shell dan browser ikon untuk memeriksa dan menggunakan sumber daya di seluruh sistem.

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

Contoh

Misalnya, lihat Berbagi Sumber Daya Ikon.

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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll