[This is preliminary documentation and subject to change.]
The IImageList interface enables the user to insert images to be used as icons for items in the result or scope pane of the console. When an image is inserted, an index is passed in and associated with the image. Any time the image is to be used, the user can refer to it by the index that he or she assigned.
Note that because the image list is shared among many components, the user-specified index is a "virtual" index that gets mapped internally to the actual index.
You do not implement the IImageList interface. It is implemented by the Microsoft Management Console.
You can use the IImageList interface whenever a snap-in component will benefit from being able to insert images that can be used as icons.
The scope pane and the result pane (if it is the default list view) each have an image list. The snap-in should add the specified images of items to display before the images are added to either of the panes. The images for the scope pane are added only once, while the images for the result pane are added every time the snap-in gets the SHOW(TRUE) notification message.
IUnknown Methods | Description |
---|---|
QueryInterface | Returns pointers to supported interfaces. |
AddRef | Increments reference count. |
Release | Decrements reference count. |
IImageList Methods | Description |
ImageListSetIcon | Sets an icon in the image list. |
ImageListSetStrip | Sets a strip of icons in the image list. |