IImageList

[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.

When to Implement

You do not implement the IImageList interface. It is implemented by the Microsoft Management Console.

When to Use

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.

Methods in Vtable Order

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.