共用方式為


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 版或更新版本)

另請參閱

IShellIcon