Metode IShellIcon::GetIconOf (shobjidl_core.h)

Artikel
03/02/2024

Mendapatkan ikon untuk objek di dalam folder tertentu.

Sintaks

HRESULT GetIconOf(
  PCUITEMID_CHILD pidl,
  UINT            flags,
  int             *pIconIndex
);

Parameter

pidl

Jenis: LPCITEMIDLIST

Alamat struktur ITEMIDLIST yang menentukan lokasi relatif folder.

flags

Jenis: UINT

Bendera yang menentukan bagaimana ikon akan ditampilkan. Parameter ini bisa nol atau salah satu nilai berikut.

GIL_FORSHELL

Ikon akan ditampilkan dalam folder Shell.

GIL_OPENICON

Ikon harus dalam status terbuka jika gambar status terbuka dan status tertutup tersedia. Jika bendera ini tidak ditentukan, ikon harus dalam status tertutup. Bendera ini biasanya digunakan untuk objek folder.

pIconIndex

Jenis: LPINT

Alamat indeks ikon dalam daftar gambar sistem. Indeks daftar gambar standar berikut dapat dikembalikan.

0

Dokumen (halaman kosong, tidak terkait)

1

Dokumen (dengan data di halaman)

2

Aplikasi (ekstensi nama file harus .exe, .com, atau .bat)

3

Folder (biasa)

4

Folder (buka)

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika lpIconIndex berisi indeks daftar gambar sistem yang benar, atau S_FALSE jika ikon tidak dapat diperoleh untuk objek ini.

Keterangan

Jika Anda tidak dapat mengambil ikon untuk objek ini menggunakan GetIconOf, gunakan metode GetUIObjectOf untuk mengambil objek yang mendukung metode Ekstrak .

IShellIcon::GetIconOf gagal jika CoInitialize tidak dipanggil terlebih dahulu.

Catatan untuk Aplikasi Panggilan

Indeks yang dikembalikan berasal dari daftar gambar sistem.

Catatan untuk Pelaksana

Jika indeks ikon yang digunakan bukan salah satu gambar standar yang tercantum, pelaksana bertanggung jawab untuk menambahkan gambar ke daftar gambar sistem dan kemudian menempatkan indeks ke dalam parameter lpIconIndex . Untuk mencegah daftar gambar sistem tumbuh terlalu besar, setiap gambar hanya boleh ditambahkan sekali.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)

Lihat juga

IShellIcon

Bagikan melalui