共用方式為


SHGetIconOverlayIndexA 函式 (shlobj_core.h)

傳回系統影像清單中的重迭圖示索引。

語法

int SHGetIconOverlayIndexA(
  [in, optional] LPCSTR pszIconPath,
                 int    iIconIndex
);

參數

[in, optional] pszIconPath

類型:LPCTSTR

包含包含圖示之檔案完整路徑之最大長度的 null 終止字串指標 MAX_PATH

iIconIndex

類型:int

pszIconPath 所指向之檔案中的圖示索引。 若要要求標準重迭圖示,請將 pszIconPath 設定為 NULL並將 iIconIndex 設為下列其中一項:

IDO_SHGIOI_SHARE (0x0FFFFFFF)

表示共用資料夾的重迭圖示。

表示連結資料夾或檔案的重迭圖示。

IDO_SHGIOI_SLOWFILE (0x0FFFFFFD)

表示緩慢檔案的重迭圖示。

IDO_SHGIOI_DEFAULT (0x0FFFFFFC)

Windows 7 和更新版本。 重迭圖示,表示專案是集合中的預設值。 其中一個範例是預設印表機。

傳回值

類型:int

如果成功,則傳回系統映射清單中的重迭圖示索引,否則會傳回 -1。

言論

圖示重疊是系統影像清單的一部分。 它們有兩個標識碼。 第一個是以單一為基礎的重疊索引,可識別相對於影像清單中其他重疊的重疊。 另一個是識別實際影像的影像索引。 這兩個索引相當於您分別指派給 iOverlay iOverlayiImage 參數的值,當您將圖示重疊新增至具有 ImageList_SetOverlayImage的私人影像清單時。 SHGetIconOverlayIndex 會傳回重疊索引。 若要將重疊索引轉換成其對等影像索引,請呼叫 INDEXTOOVERLAYMASK

注意 在初始化期間將映射載入系統映射清單中之後,就無法變更。 pszIconPath 所指定的檔名和索引iIconIndex 只會用來識別圖示重疊。 SHGetIconOverlayIndex 無法用來修改系統映射清單。
 

注意

shlobj_core.h 標頭會根據 UNICODE 預處理器常數的定義,將 SHGetIconOverlayIndex 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlobj_core.h (包括 Shlobj.h, Shlobj_core.h)
連結庫 Shell32.lib
DLL Shell32.dll 版 (5.0 版或更新版本)

另請參閱

IShellIconOverlay

IShellIconOverlayIdentifier