IShellIcon::GetIconOf 方法 (shobjidl_core.h)
取得特定資料夾內物件的圖示。
語法
HRESULT GetIconOf(
PCUITEMID_CHILD pidl,
UINT flags,
int *pIconIndex
);
參數
pidl
類型: LPCITEMIDLIST
指定資料夾相對位置 之 ITEMIDLIST 結構的位址。
flags
類型: UINT
指定圖示顯示方式的旗標。 此參數可以是零或下列其中一個值。
GIL_FORSHELL
圖示會顯示在Shell資料夾中。
GIL_OPENICON
如果開啟狀態和關閉狀態影像都可用,圖示應該處於開啟狀態。 如果未指定此旗標,圖示應該處於關閉狀態。 這個旗標通常用於資料夾物件。
pIconIndex
類型: LPINT
系統映像清單中的圖示索引位址。 您可以傳回下列標準映像清單索引。
0
檔 (空白頁面,未相關聯)
1
使用頁面上數據的檔 ()
2
應用程式 (擴展名必須是 .exe、.com或 .bat)
3
資料夾 (純)
4
資料夾 (開啟)
傳回值
類型: HRESULT
如果 lpIconIndex 包含正確的系統影像清單索引,則傳回S_OK如果無法取得此對象的圖示,則傳回S_FALSE。
備註
如果您無法使用 GetIconOf 擷取此物件的圖示,請使用 GetUIObjectOf 方法來擷 取支援 Extract 方法的物件。
如果未先呼叫 CoInitialize,IShellIcon::GetIconOf 就會失敗。
呼叫應用程式注意事項
傳回的索引來自系統映像清單。實作者注意事項
如果使用的圖示索引不是列出的其中一個標準映像,實作者必須負責將映像新增至系統映射清單,然後將索引放入 lpIconIndex 參數中。 若要防止系統映射清單成長太大,每個映像應該只新增一次。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包括 Shobjidl.h) |
Dll | Shell32.dll (4.0 版或更新版本) |