method Edit.Images (Handle as Variant)
Sets the control's images list at runtime. The Handle should be a handle to an Image List control.

 TypeDescription 
   Handle as Variant The Handle parameter could be:
  • 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.
  • 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..."
  • A string expression that specifies the ICO file to be loaded. 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("e:\working\sync.ico") method  adds the sync.ico file to the control's Images collection. ( available for DPI-Aware version only )
 
The control provides an image list window, that's displayed at design time. Use the ShowImageList property to hide the image list window, at design time. At design time, the user can add new icons to the control's Images collection, by dragging icon files, exe files, etc, to the images list window. At runtime, the user can use the Images and ReplaceIcon method to change the Images collection. The Images collection is 1 based. The control's context list may contain icons. Use the BookmarkImageLine property to assign an icon to the control's bookmarks header. Use the BookmarkImage property to display the control's bookmarks header.

The following VB sample loads two icons using BASE64 encoded strings:

If you run the sample you get:

The following sample shows how to replace the entire list of icons, using a Microsoft Image List control ( ImageList1 ):

Edit1.Images ImageList1.hImageList

The following C++ sample loads two icons using BASE64 encoded strings:

The following VB.NET sample loads two icons using BASE64 encoded strings:

The following C# sample loads two icons using BASE64 encoded strings:

The following VFP sample loads two icons using BASE64 encoded strings:

The following screen shot shows the control's images panel, where user can drag icon files in order to add new icons to the control at design mode:


Send comments on this topic.
1999-2016 Exontrol.COM, Software. All rights reserved.