wraps the IImageList2 interface and provides additional methods for manipulating and interacting with image lists.
| AutoHotkey | AHK v2 alpha |
| OS | Windows Vista / Windows Server 2008 or newer |
| Base classes | Unknown, ImageList |
| Helper classes | ILGOS, ILDI, ILFIP, IMAGELISTDRAWPARAMS, IMAGELISTSTATS, ILC, ILR |
| ImageList2 | wraps the IImageList2 interface and provides additional methods for manipulating and interacting with image lists. |
| Variables | |
| CLSID | This is CLSID_ImageList. |
| IID | This is IID_IImageList2. |
| Functions | |
| Resize | Resizes the current image. |
| GetOriginalSize | Gets the original size of a specified image. |
| SetOriginalSize | Sets the original size of a specified image. |
| SetCallback | Not implemented |
| GetCallback | Not implemented |
| ForceImagePresent | Forces an image present, as specified. |
| DiscardImages | Discards images from list, as specified. |
| PreloadImages | Preloads images, as specified. |
| GetStatistics | Gets an image list statistics structure. |
| Initialize | Initializes an image list. |
| Replace2 | Replaces an image in an image list. |
| ReplaceFromImageList | Replaces an image in one image list with an image from another image list. |
Resize( width, height )
Resizes the current image.
| INT width | the new width in pixels |
| INT height | the new height in pixels |
| BOOL success | true on success, false otherwise |
To set the present image, use ForceImagePresent.
GetOriginalSize( index, flags, byRef width, byRef height )
Gets the original size of a specified image.
| INT index | The index of desired image. |
| UINT flags | Flags for getting original size. You can use one of the fields of the ILGOS class for convenience. |
| byRef INT width | receives the original width |
| byRef INT height | receives the original height |
| BOOL success | true on success, false otherwise |
DiscardImages( start, end, flags )
Discards images from list, as specified.
| INT start | the index of the first image to discard. |
| INT end | the index of last image to discard. |
| UINT flags | Discard images flags. You may use the fields of the ILDI class for convenience. |
| BOOL success | true on success, false otherwise |
Initialize( width, height, flags, initial, max )
Initializes an image list.
| INT width | Width, in pixels, of each image. |
| INT height | Height, in pixels, of each image. |
| UINT flags | A combination of Image List Creation Flags. You can use the fields of the ILC class for convenience. |
| INI initial | Number of images that the image list initially contains. |
| INT max | Number of new images that the image list can contain. |
| BOOL success | true on success, false otherwise |
Replace2( index, image, flags, mask : = 0, punk : = 0 )
Replaces an image in an image list.
| INT index | the index of the image to replace. |
| HBITMAP image | A handle to the bitmap that contains the new image. |
| UINT flags | Specifies how the mask is applied to the image as one or a bitwise combination of the flags in the ILR class. |
| [opt] HBITMAP mask | A handle to the bitmap that contains the mask. If no mask is used with the image list, this parameter is ignored. |
| [opt] IUnknown punk | A pointer to the IUnknown interface. (not sure what this does) |
| BOOL success | true on success, false otherwise |
ReplaceFromImageList( index, src, srcIndex, punk : = 0 )
Replaces an image in one image list with an image from another image list.
| INT index | The index of the destination image in the image list. This is the image that is overwritten by the new image. |
| ImageList src | either an ImageList instance pointing to the source image list or a raw pointer such as returned by IL_Create() |
| INT srcIndex | The index of the source image in the image list pointed to by src. |
| [opt] IUnknown punk | A pointer to the IUnknown interface. (not sure what this does) |
| BOOL success | true on success, false otherwise |
Resizes the current image.
Resize( width, height )
Gets the original size of a specified image.
GetOriginalSize( index, flags, byRef width, byRef height )
Sets the original size of a specified image.
SetOriginalSize( index, width, height )
Not implemented
SetCallback( p* )
Not implemented
GetCallback( p* )
Forces an image present, as specified.
ForceImagePresent( index, flags )
Discards images from list, as specified.
DiscardImages( start, end, flags )
Preloads images, as specified.
PreloadImages( params )
Gets an image list statistics structure.
GetStatistics()
Initializes an image list.
Initialize( width, height, flags, initial, max )
Replaces an image in an image list.
Replace2( index, image, flags, mask : = 0, punk : = 0 )
Replaces an image in one image list with an image from another image list.
ReplaceFromImageList( index, src, srcIndex, punk : = 0 )