Fungsi LookupIconIdFromDirectoryEx (winuser.h)

Artikel
05/25/2023

Mencari melalui ikon (RT_GROUP_ICON) atau data sumber daya kursor (RT_GROUP_CURSOR) untuk ikon atau kursor yang paling sesuai dengan perangkat tampilan saat ini.

Jika ada lebih dari satu gambar dalam grup sumber daya, metode ini menggunakan kriteria berikut untuk memilih gambar:

Gambar terdekat tetapi tidak melebihi ukuran yang diminta dipilih.
Jika ada dua atau beberapa gambar dengan ukuran tersebut, gambar yang cocok dengan kedalaman warna tampilan dipilih.
Jika tidak ada gambar yang sama persis dengan kedalaman warna tampilan, gambar dengan kedalaman warna terbesar yang tidak melebihi kedalaman warna tampilan dipilih. Jika semua melebihi kedalaman warna, yang memiliki kedalaman warna terendah dipilih.

Sintaks

int LookupIconIdFromDirectoryEx(
  [in] PBYTE presbits,
  [in] BOOL  fIcon,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parameter

[in] presbits

Jenis: PBYTE

Ikon atau data direktori kursor. Karena fungsi ini tidak memvalidasi data sumber daya, fungsi ini menyebabkan kesalahan perlindungan umum (GP) atau mengembalikan nilai yang tidak terdefinisi jika presbit tidak menunjuk ke data sumber daya yang valid.

[in] fIcon

Jenis: BOOL

Menunjukkan apakah ikon atau kursor dicari. Jika parameter ini TRUE, fungsi sedang mencari ikon; jika parameternya FALSE, fungsi sedang mencari kursor.

[in] cxDesired

Jenis: int

Lebar yang diinginkan, dalam piksel, ikon. Jika parameter ini nol, fungsi menggunakan nilai metrik sistem SM_CXICON atau SM_CXCURSOR .

[in] cyDesired

Jenis: int

Tinggi yang diinginkan, dalam piksel, ikon. Jika parameter ini nol, fungsi menggunakan nilai metrik sistem SM_CYICON atau SM_CYCURSOR .

[in] Flags

Jenis: UINT

Kombinasi nilai berikut.

Nilai	Makna
LR_DEFAULTCOLOR 0x00000000	Menggunakan format warna default.
LR_MONOCHROME 0x00000001	Membuat ikon atau kursor monokrom.

Nilai kembali

Jenis: int

Jika fungsi berhasil, nilai yang dikembalikan adalah pengidentifikasi sumber daya bilangan bulat untuk ikon (RT_ICON) atau kursor (RT_CURSOR) yang paling sesuai dengan perangkat tampilan saat ini.

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

Keterangan

File sumber daya jenis RT_GROUP_ICON (RT_GROUP_CURSOR menunjukkan kursor) berisi data ikon (atau kursor) dalam beberapa format yang bergantung pada perangkat dan independen perangkat. LookupIconIdFromDirectoryEx mencari file sumber daya untuk ikon (atau kursor) yang paling sesuai dengan perangkat tampilan saat ini dan mengembalikan pengidentifikasi bilangan bulatnya. Fungsi FindResource dan FindResourceEx menggunakan makro MAKEINTRESOURCE dengan pengidentifikasi ini untuk menemukan sumber daya dalam modul.

Direktori ikon dimuat dari file sumber daya dengan jenis sumber daya RT_GROUP_ICON (atau RT_GROUP_CURSOR untuk kursor), dan nama sumber daya bilangan bulat untuk ikon tertentu (RT_ICON) atau kursor (RT_CURSOR) yang akan dimuat. Fungsi LoadResource dan CreateIconFromResourceEx dapat digunakan untuk membuat ikon atau kursor yang sesuai.

Fungsi LoadIcon, LoadImage, dan LoadCursor menggunakan fungsi ini untuk mencari data sumber daya yang ditentukan untuk ikon atau kursor yang paling sesuai dengan perangkat tampilan saat ini. LoadIconWithScaleDown menggunakan kriteria pencarian alternatif agar paling cocok.

Contoh

Misalnya, lihat Berbagi Sumber Daya Ikon.

Persyaratan


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