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