IShellIconOverlayManager interface (shlobj_core.h)

  • Article

[IShellIconOverlayManager is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Exposes methods that retrieve the icon overlay information, including the overlay index and the image index for an IShellFolder object. This interface iterates through all the icon overlay IDs and keeps the information in an array.

Inheritance

The IShellIconOverlayManager interface inherits from the IUnknown interface. IShellIconOverlayManager also has these types of members:

Methods

The IShellIconOverlayManager interface has these methods.

 
IShellIconOverlayManager::GetFileOverlayInfo

Gets the index of the icon overlay or the icon image for the specified file with the specified attributes.
IShellIconOverlayManager::GetReservedOverlayInfo

Gets the index of the icon overlay or the icon image for the specified file with the specified attributes from one of the reserved overlays.
IShellIconOverlayManager::LoadNonloadedOverlayIdentifiers

Loads any registered overlay identifiers, or handlers, that are not currently loaded.
IShellIconOverlayManager::OverlayIndexFromImageIndex

Finds the index of an overlay image for the specified icon image. It can add an overlay if one is not found for the icon.
IShellIconOverlayManager::RefreshOverlayImages

Refreshes the overlay cache, the image list, or both.

Remarks

Icon overlays are small images placed at the lower-left corner of the icon that represents a Shell object in Windows Explorer or on the desktop. They are used to add some extra information to the object's normal icon. A commonly used icon overlay is the small arrow that indicates that a file or folder is actually a link. For more information, see IShellIconOverlay.

This interface must be implemented by all icon overlay handlers.

This interface is not typically called by applications.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj_core.h