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 版) |