Schedule.Images Method (ExSchedule)

The user can add images at design time, by drag and drop files to control's images holder. The ImageSize property defines the size (width/height) of the icons within the control's Images collection. The ShowImageList property available for the /COM shows or hides the control's images holder at design mode. Use the ReplaceIcon method to add, remove or clear icons in the control's images collection.

The Images method loads icons to the control, HTMLPicture assigns a key to a picture object, and the Pictures collection handles the identifiers of the pictures that can be used in the Pictures or ExtraPictures properties.

In order to display an icon or a picture in the control you need first to load the icons or the pictures you plan to display, using the Images method, HTMLPicture, or Add method of the ExPictures collection. The Images collection can display only 16x16 icons, while the HTMLPicture, or Add method can load and display custom sized pictures. The Width/Height property specifies the width and height of the picture to be displayed in the event's body.

The event can display icons, pictures several ways as follows:

Using the <img> HTML tag, if used in any label properties such as LongLabel or ExtraLabel property. The ShortLabel property can NOT display images or HTML font attributes. For instance, this option can be used to display a default icon or picture for all events in the control using the DefaultEventLongLabel property. Also, the <img> TAG can be used to any label or caption property that supports HTML format.
Using the Pictures property of the Event object, which indicates a list of pictures from Pictures collection to be displayed on the event's body. The PicturesAlign property indicates the alignment of the pictures relative to the borders of the event. The hand cursor is shown, if the ExPicture.ShowCursorHand property is set, when the cursor hovers the picture. The PictureClick event is fired if the user clicks a picture on event's picture. You can use the PictureFromPoint property to get the identifier of the picture from the cursor.
Using the ExtraPictures property of the Event object, which indicates a list of pictures from Pictures collection to be displayed on the event's body. The ExtraPicturesAlign property indicates the alignment of the pictures relative to the borders of the event. The hand cursor is shown, if the ExPicture.ShowCursorHand property is set, when the cursor hovers the picture. The PictureClick event is fired if the user clicks a picture on event's picture. You can use the PictureFromPoint property to get the identifier of the picture from the cursor.

The Pictures and ExtraPictures may display one or more pictures at the time. The , character indicates the separator of pictures in the same line, while the / character divides the lines to show the pictures. For instance, "1,2" displays icon with the index 1 and 2 on the same line, while the "1/2,pic1" displays the first icon on the first line, the second icon and the picture pic1 on the second line.

		Type	Description
		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)