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_LINK (0x0FFFFFFE)
表示連結資料夾或檔案的重迭圖示。
IDO_SHGIOI_SLOWFILE (0x0FFFFFFD)
表示緩慢檔案的重迭圖示。
IDO_SHGIOI_DEFAULT (0x0FFFFFFC)
Windows 7 和更新版本。 重迭圖示,表示專案是集合中的預設值。 其中一個範例是預設印表機。
傳回值
類型:int
如果成功,則傳回系統映射清單中的重迭圖示索引,否則會傳回 -1。
言論
圖示重疊是系統影像清單的一部分。 它們有兩個標識碼。 第一個是以單一為基礎的重疊索引,可識別相對於影像清單中其他重疊的重疊。 另一個是識別實際影像的影像索引。 這兩個索引相當於您分別指派給 iOverlay iOverlay 和 iImage 參數的值,當您將圖示重疊新增至具有 ImageList_SetOverlayImage的私人影像清單時。 SHGetIconOverlayIndex 會傳回重疊索引。 若要將重疊索引轉換成其對等影像索引,請呼叫 INDEXTOOVERLAYMASK。
注意
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 版或更新版本) |