Fungsi SHGetImageList (shellapi.h)

Mengambil daftar gambar.

Syntax

SHSTDAPI SHGetImageList(
  [in]  int    iImageList,
  [in]  REFIID riid,
  [out] void   **ppvObj
);

Parameter-parameternya

[in] iImageList

Jenis: int

Jenis gambar yang terkandung dalam daftar. Salah satu dari nilai berikut:

SHIL_LARGE (0x0)

0x0. Ukuran gambar biasanya 32x32 piksel. Namun, jika opsi Gunakan ikon besar dipilih dari bagian Efek pada tab Tampilan di Properti Tampilan, gambarnya adalah 48x48 piksel.

SHIL_SMALL (0x1)

0x1. Gambar-gambar ini adalah ukuran ikon kecil standar Shell 16x16, tetapi ukurannya dapat disesuaikan oleh pengguna.

SHIL_EXTRALARGE (0x2)

0x2. Gambar-gambar ini adalah ukuran ikon ekstra besar standar Shell. Ini biasanya 48x48, tetapi ukurannya dapat disesuaikan oleh pengguna.

SHIL_SYSSMALL (0x3)

0x3. Gambar-gambar ini adalah ukuran yang ditentukan oleh GetSystemMetrics yang dipanggil dengan SM_CXSMICON dan GetSystemMetrics yang dipanggil dengan SM_CYSMICON.

SHIL_JUMBO (0x4)

0x4. Windows Vista dan yang lebih baru. Gambar biasanya 256x256 piksel.

SHIL_LAST

Nilai bendera valid terbesar, untuk tujuan validasi.

[in] riid

Jenis: REFIID

Referensi ke pengidentifikasi antarmuka daftar gambar, biasanya IID_IImageList.

[out] ppvObj

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IImageList.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Komentar

Jenis penunjuk IImageList , seperti yang dikembalikan dalam parameter ppv , dapat ditransmisikan sebagai HIMAGELIST sesuai kebutuhan; misalnya, untuk digunakan dalam tampilan daftar. Sebaliknya, HIMAGELIST dapat dilemparkan sebagai pointer ke IImageList.

Pada Windows Vista, SHIL_SMALL, SHIL_LARGE, dan SHIL_EXTRALARGE menskalakan dengan titik per inci (dpi) jika proses ditandai sebagai sadar dpi. Untuk mengatur jenis ini menjadi dpi-aware, panggil SetProcessDPIAware. SHIL_JUMBO diperbaiki pada 256 piksel terlepas dari pengaturan sadar dpi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
Set API	ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan di Windows 10, versi 10.0.14393)

Lihat juga

FileIconInit