method PropertiesList.Images (Handle as Variant)
Sets the control's image list at runtime.

TypeDescription
Handle as Variant The Handle parameter can be:
  • A string expression that specifies the ICO file to add. The ICO file format is an image file format for computer icons in Microsoft Windows. ICO files contain one or more small images at multiple sizes and color depths, such that they may be scaled appropriately. For instance, Images("c:\temp\copy.ico") method adds the sync.ico file to the control's Images collection (string, loads the icon using its path) 
  • A string expression that indicates the BASE64 encoded string that holds the icons list. Use the Exontrol's ExImages tool to save/load your icons as BASE64 encoded format. In this case the string may begin with "gBJJ..." (string, loads icons using base64 encoded string)
  • A reference to a Microsoft ImageList control (mscomctl.ocx, MSComctlLib.ImageList type) that holds the icons to add (object, loads icons from a Microsoft ImageList control)
  • A reference to a Picture (IPictureDisp implementation) that holds the icon to add. For instance, the VB's LoadPicture (Function LoadPicture([FileName], [Size], [ColorDepth], [X], [Y]) As IPictureDisp) or LoadResPicture (Function LoadResPicture(id, restype As Integer) As IPictureDisp) returns a picture object (object, loads icon from a Picture object)
  • A long expression that identifies a handle to an Image List Control ( the Handle should be of HIMAGELIST type ). On 64-bit platforms, the Handle parameter must be a Variant of LongLong / LONG_PTR data type ( signed 64-bit (8-byte) integers ), saved under llVal field, as VT_I8 type. The LONGLONG / LONG_PTR is __int64, a 64-bit integer. For instance, in C++ you can use as Images( COleVariant( (LONG_PTR)hImageList) ) or Images( COleVariant( (LONGLONG)hImageList) ), where hImageList is of HIMAGELIST type. The GetSafeHandle() method of the CImageList gets the HIMAGELIST handle (long, loads icon from HIMAGELIST type)
Use the Images method to attach a list of icons to the control. The ImageSize property defines the size (width/height) of the icons within the control's Images collection.  At runtime, the user can use the Images and ReplaceIcon method to change the Images collection. Use the HTMLName property to assign built-in HTML format to a property. In design mode, user can add icons to the control using the control's Template page. No matter what programming language you are using, you can have a quick view of the component's features using the WYSWYG Template editor. It's a nice feature and we don't want you to miss it. 

The Template feature lets you to use a simple x-script language to call properties and methods of the control at design as well at runtime. You can use this feature to build x-script strings to pass them at runtime.

For instance, the following template sample adds three properties and assign an icon to each of them, using the <img> tag.

BeginUpdate 
Images("gBJJgBAIDAAGAAEAAQhYAf8Pf4hh0QihCJo2AEZjQAjEZFEaIEaEEaAIAkcbk0olUrlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/syEQSEADGYbGAGCwj/jWKxuPjOEyOJwcOxuVx2MyOViGAz0szWUwmOx2TjOh1Ea0OjzGt1mL1UPuuZ2Vcw2I29NzOXyWJ1WiwuHieM0uW0fA0O51G1uedzvK5lS3PT4W5qW9xnO2XP4WnyEzztw2nZ2XQxnmpPU3HV9mI7WhnWk13f8nE+fhy2T+WvlH4tz3uC9ztvK4TuQE+CeusjT1QC4cHQAmjxwc0zLM7CT8NXBrcuK07orTC8CQPBsAPQ9CaQUjMUQ1ArZRA+sJpWx0GQo88WRe4sMwZDkYLVEkbQdEzfMnA0eJjHcVPRAD9wfDyNwklzsN+70pyElcNsqjb/LLJciS65jCSCxcmpfK7exS4UZR/F0gO6l81whKrezlEcBxqxEdy0sjUs2/kvQzOExQQmEdSxBcfyU+86yMzkWxi2MEPROcKTK/sxx7KTgQlBU5zyncGUjR8mTsms31DJE1UNEVKSzSy4yXLkQyKokAQs+lFQjRkb1DLUk0bM71zvQsO0EvdXvmqlaVinEJUlUSUVBYcq1XULPpVJauTgm01uxW9UzZO9vWnaNq3I5FFWTSFD3PWM8VbctivnYz+XlTN43tQKyosHyV32jyQJEkgAJKlGBpxTt3p4iiNnmf+GI2cB/4hh4fnAH6NmAB+MYuAZgIMjRAADkCN5BkSNoNjyNZPkYDkAA+HgOcGXI0fAH5ojZ/AfnEsk+f5P1Y6KAg")
Add("Icon1","",1).HTMLName = "1Icon 1"
Add("Icon2","",1).HTMLName = "2Icon 2"
Add("Icon3","",1).HTMLName = "3Icon 3"
EndUpdate