fIMAGELIST

Quick Data

General Description

The fIMAGELIST class is a class designed to handle a set of images from one location. By having a set of the same size images in one continuous set, the total space in memory required for all of the images can be reduced.

So, what it boils down to is that this can be a convenient way to store a lot of images that are the same size and colour depth. However, the main use of this component is to partner with the fLISTVIEW control and provide it with icons to use.

Bitdepths

When creating an imagelist, you will need to specify a bit-depth for all of the images. You can use the constants shown below to specify that bitdepth.

Properties

Methods

Sample Code

The following snippet gives a basic idea of how to use this component.

//Create an image list...
fIMAGELIST ImgList;
//Create a list that has images each 32x32 pixels,
//at 8-bits-per-pixel, initially 10 images, and
//resize by 10 each time a resize is needed.
ImgList.Create(32, 32, bd8BPP, 10, 10);

//Now add some images (icons in this case).
ImgList.AddIcon(Icon);                      //Just from a HICON you had...
ImgList.AddIcon("MAIN_ICON", 0);            //Load MAIN_ICON from resources.
HINSTANCE DLLInst = LoadLibrary("MYDLL.DLL");
ImgList.AddIcon(DLLInst, "OTHER_ICON", 0);  //Load from a DLL.
FreeLibrary(DLLInst);                       //Unload the DLL! Don't forget!
ImgList.AddIcon("c:\Windows\icon.ico");     //Load from file.
ImgList.LoadIconFromDLL("SHELL32.DLL", 10); //Load the 10th icon.
//Please note that with the above function, only the 32x32 8BPP version
//will be loaded. There are several versions of each icon in the DLL.
//Only the 32x32 8BPP will be loaded because that is the type of image
//list that you have created.

//Now return an icon or two...
HICON Icon = ImgList.GetIcon(3, ILD_NORMAL);                                            

//When you are done, you might like to destroy the imagelist.
//However, this is done automatically for you when the class
//is destroyed.
ImgList.Destroy();

//Now here's a use for this imagelist: animation. Let's say that
//you create a bitmap that is 32 pixels high, but 320 pixels wide.
//Inside this picture is a series of 32 pixel wide frames, side by
//side. What you'd do first is to save this file as an icon,
//and then load it into the image list.
//All of the pixels that are white will be made transparent. If you
//want to keep white non-transparent, then just change the transparent
//stuff to something very close to white.
//Anyway, the next line loads the file animation.ico, and specifies that
//each image is 32 pixels wide - Windows splits up the images on the
//32 pixel border. Next, we say that whenever more memory needs to
//be allocated, allocate it in one image segments. Finally, we
//say to change all pixels that are white into transparent.
ImgList.LoadPremadeIcon("animation.ico", 32, 1, RGB(255,255,255));

//Now just cycle through the images, drawing them
//on the specified HDC.
for (int ITemp = 0; ITemp < 10; ITemp++)
    {
    //The next line draws: Image no ITemp, on the device context
    //HandleDC, at (10,10), and draws transparently.
    ImgList.DrawImage(ITemp, HandleDC, 10, 10, ILD_TRANSPARENT);
    }

//And that's about it...