IShellIconOverlay 介面 (shlobj_core.h)

公開命名空間延伸模組用來指定其包含之物件的圖示重迭的方法。

繼承

IShellIconOverlay介面繼承自IUnknown介面。 IShellIconOverlay 也有下列類型的成員：

方法

IShellIconOverlay介面具有這些方法。

IShellIconOverlay：：GetOverlayIconIndex 取得系統映射清單中的圖示重迭索引。
IShellIconOverlay：：GetOverlayIndex 取得系統映射清單中的重迭索引。

備註

圖示重迭是位於圖示左下角的小型影像，代表 Shell 物件。 它們通常用來將一些額外的資訊新增至圖示。 常用的圖示重迭是小箭號，表示檔案或資料夾圖示代表快捷方式。

圖示重迭是系統映射清單的一部分。 它們有兩個識別碼。 其中一個是以單一為基礎的重迭索引，可識別相對於影像清單中其他重迭的重迭。 另一個是識別實際影像的影像索引。 當您使用ImageList：：SetOverlayImage將圖示重迭新增至私人影像清單時，這兩個索引相當於您分別指派給iOverlay和iImage參數的值。

在顯示物件的圖示之前，Shell 會呼叫相關聯的資料夾 IShellIconOverlay 介面，以查詢物件的圖示是否應該有重迭。 通常它會呼叫 IShellIconOverlay：：GetOverlayIndex 來要求重迭的重迭索引。 在某些情況下，Shell 可能會呼叫 IShellIconOverlay：：GetOverlayIconIndex 來要求重迭的影像索引。 若要指定圖示重迭，方法必須傳回要求的索引。 否則，它們會傳回S_FALSE。

若要指定圖示重迭，這兩種方法必須先呼叫 SHGetIconOverlayIndex，以擷取系統映射清單中的重迭索引。 第一次呼叫 SHGetIconOverlayIndex 時，Shell 會使用重迭的檔案名和索引，將影像新增至系統映射清單。 重迭在系統映射清單中之後，Shell 只會使用檔案名和索引作為識別碼。 您也可以使用 SHGetIconOverlayIndex 來擷取數個標準系統重迭的重迭索引。 IShellIconOverlay：：GetOverlayIndex 只會將重迭索引傳回殼層。 IShellIconOverlay：：GetOverlayIconIndex 必須使用 INDEXTOOVERLAYMASK 宏，將重迭索引轉換成對等影像索引。

系統可支援的不同圖示重迭處理常式數目受限於系統映射清單中的圖示重迭可用空間量。 目前有 15 個位置配置給圖示重迭，其中部分由系統保留。 基於這個理由，只有在沒有滿意的替代方案時，才應該指定圖示重迭。

此介面是由命名空間延伸模組實作，這些延伸模組需要為其物件指定圖示重迭。

應用程式通常不會使用此介面。

規格需求

最低支援的用戶端	Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	shlobj_core.h