SHGetImageList 函式 (shellapi.h)

擷取影像清單。

語法

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

參數

[in] iImageList

類型： int

清單中所包含的影像類型。 下列其中一個值：

SHIL_LARGE (0x0)

0x0。 影像大小通常為32x32圖元。 不過，如果已從 [顯示屬性] 中 [外觀] 索引標籤的 [效果] 區段選取 [使用大型圖示] 選項，影像就會是 48x48 圖元。

SHIL_SMALL (0x1)

0x1。 這些影像是殼層標準小型圖示大小 16x16，但大小可由使用者自定義。

SHIL_EXTRALARGE (0x2)

0x2。 這些影像是Shell標準超大型圖示大小。 這通常是 48x48，但大小可由使用者自定義。

SHIL_SYSSMALL (0x3)

0x3。 這些映像是由呼叫的 GetSystemMetrics 所指定的大小，使用 SM_CXSMICON 和使用 SM_CYSMICON 呼叫的 GetSystemMetrics。

SHIL_JUMBO (0x4)

0x4。 Windows Vista 和更新版本。 影像通常是 256x256 像素。

SHIL_LAST

用於驗證用途的最大有效旗標值。

[in] riid

類型： REFIID

映射清單介面標識碼的參考，通常IID_IImageList。

[out] ppvObj

類型： void**

當這個方法傳回時，會包含 riid中要求的介面指標。 這通常是 ImageList。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

IImageList 指標類型，例如在 ppv 參數中傳回的指標類型，可以視需要轉換成 HIMAGELIST;例如，用於清單檢視。 相反地， HIMAGELIST 可以轉換成 IImageList 的指標。

從 Windows Vista 起，如果程式標示為 dpi 感知，則SHIL_SMALL、 SHIL_LARGE和 SHIL_EXTRALARGE 尺規，每英吋的點數 (dpi) 。 若要將這些類型設定為 dpi 感知，請呼叫 SetProcessDPIAware。 不論 dpi 感知設定為何，SHIL_JUMBO固定為 256 圖元。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shellapi.h
Dll	Shell32.dll
API 集合	ext-ms-win-shell-shell32-l1-2-2 (Windows 10 10.0.14393 版)

另請參閱

FileIconInit