MAXScript Tools and Interaction with 3ds Max > Creating MAXScript Tools > ActiveX Controls in MAXScript Rollouts > Typical ActiveX Controls > Other ActiveX Control Examples >

# ImageList ActiveX Control

    "Microsoft ImageList Control 6.0 (SP4)"
    "MSComctlLib.ImageListCtrl.2"
    "{2C247F23-8591-11D1-B16A-00C0F0283628}"

Note

ActiveX Controls have been deprecated by Microsoft in the latest versions of the Windows operating system in favor of the DotNet framework and its controls.

While MAXScript still supports ActiveX controls, these have to be installed and registered on the system to be accessible to MAXScript.

As a replacement of ActiveX controls, MAXScript supports DotNet controls in 3ds Max 9 and higher.

Description:

The ImageList ActiveX Control can be used to create, manage and supply images to other ActiveX Controls like the ListView ActiveX Control and the TreeView ActiveX Control to be used as icons.

Constructor:

    activeXControl ilctrl "MSComctlLib.ImageListCtrl"

Properties:

    .ImageHeight : integer

Get/Set the height of the image in pixels.

    .ImageWidth : integer

Get/Set the width of the image in pixels.

    .MaskColor : OLE_COLOR

Get/Set the mask color as OLE_COLOR value. The pixels with this color will show the background color when the .UseMaskColor property is set to true.

    .UseMaskColor : boolean

When set to true, pixels matching the color specified by the .MaskColor property will not be drawn and will show the background color. When set to false, the .MaskColor will not be used.

    .BackColor : OLE_COLOR

Defines the background color.

    .Overlay Key1:undefined Key2:undefined

Defines the overlay keys.

    .hImageList : OLE_HANDLE

Returns the OLE_HANDLE to the Image List for use in the windows.SendMessage method.

    .ListImages : IImages

Returns the imageList array containing the stored images. It has its own Properties and Methods as described below:

## ListImages Properties and Methods

Properties:

    .ListImages.Count : integer

Returns the number of images stored in the ListImages array.

    .ListImages[Index] : IImage

Returns the indexed image from the list. The index is 1-based.

Methods

    .Add Index:undefined Key:undefined Picture:undefined

Adds a new image to the list.Index is the index of the image to be added, key is a user-defined name property to identify the image and picture is an IPictureDisp value returned by the loadPicture method

See the tutorial How To ... Develop a Scene Browser using TreeView ActiveX Control - Part Two for a practical example.

    .Clear()

Removes all images from the list.

    .Remove Index:undefined

Removes the indexed image from the list. Index is 1-based.

#### See Also

- ActiveX Controls in MAXScript Rollouts

- ListView ActiveX Control

- TreeView ActiveX Control

- TabStrip ActiveX Control

- How To ... Develop a Scene Browser using TreeView ActiveX Control - Part Two