Fungsi LookupIconIdFromDirectory (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.

Untuk menentukan tinggi atau lebar yang diinginkan, gunakan fungsi LookupIconIdFromDirectoryEx . Fungsi ini memanggilnya dengan melewati nol dalam parameter cxDesired/cyDesired .

Sintaks

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

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.

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. LookupIconIdFromDirectory 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 yang akan dimuat. LookupIconIdFromDirectory mengembalikan pengidentifikasi bilangan bulat yang merupakan nama sumber daya ikon yang paling sesuai dengan perangkat tampilan saat ini.

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

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