exrollist - what's new
Exontrol ExRolList Component - Release Notes (https://exontrol.com/exrollist.jsp)

16.0.0.2 Sep 02, 2024
*NEW:   The ex-HTML tags, including fgcolor, bgcolor, gra, out, sha, solidline, and dotline, now support 150 named colors, such as <fgcolor red>, as well as RGB format specifications like <fgcolor rgb(255,0,0)>. This enhancement offers more flexibility in defining colors within ex-HTML tags
*Added: The <solidline> and <dotline> HTML tags support color in RGB format using the <solidline RRGGBB> or <dotline RRGGBB> syntax, which indicates the color to show the solid or dotted line
*Added: The ExecuteTemplate() method can return the value of a variable. For instance, the eXSurface's PointToPosition method uses variables by reference which is not supported in PowerBuilder. For that you can use a code like ExecuteTemplate("dim x,y;x=-1;y=-1;PointToPosition(x,y);x") that returns the x-position (surface's coordinates) of the current mouse pointer. In the same manner you can use ExecuteTemplate("dim x,y;x=-1;y=-1;PointToPosition(x,y);y") to return the y-position.

16.0.0.1 May 20, 2024
*Added: The ShowToolTip method can be used to update the object's tooltip, title or position. For instance, ShowToolTip(`<null>`,`<null>`,,`+8`,`+8`) during MouseMove event, shows the tooltip of the object moved relative to its default position.
*Fixed: The ShowToolTip() method works improperly as it may show the tooltip to a different position
*Fixed: The expropertieslist/com fails if the user is trying to spy the control (x64 version only, AllowSpy property, browses the object by drag and drop)

15.0.0.2 Nov 24, 2023
*Added: Update the samples to support x64 configuration (/COM version)
*Fixed: No control frame is shown in design-mode under MS Excel's spreadsheet
*Added: The control's tooltip is shown when the cursor hovers it no matter if the window that hosts the control is activated

15.0.0.1 May 15, 2023
*NEW:   Ability to specify the size to show the icons within the control
*Added: ImageSize property specifies the size of the control' icons. By default, the ImageSize property is 16. The control's Images collection is cleared if the ImageSize property is changed, so it is recommended to set the ImageSize property before calling the Images method.
*Fixed: The AttachTemplate method fails if using "handle" keyword on x64 version

14.0.0.1 Jan 23, 2023
*Added: DPI-Aware Support
*Added: New visual appearance for all internal icons to support high DPI resolution (100%, 125%, 150%, 175% , 200% and , 300%)
*Fixed: The internal icons are stretched and look distorted when DPI scalling is not 100%

13.0.0.2 Sep 12, 2022
*Added: TemplateDef/TemplatePut property allows defining inside variables for the Template feature ( available for /COM only, and useful to assign properties with multiple parameters, which is not supported in dBASE )
*Fixed: A GPF may occur on closing the form/window/dialog if one or more events are handled by AttachTemplate method

13.0.0.1 Apr 04, 2022
*Added: PowerBuilder 21.0 sample
*Fixed: Clicking (Custom) property generates "Class Not Registered" error (Windows x64, 'Looking for object with CLSID:{7EBDAAE1-8120-11CF-899F-00AA00688B10}')
*Fixed: The Background (exToolTipForeColor) property does not apply to the tooltip's title

12.0.0.1 Mar 10, 2021
*Added: ExRolList.pdf (include the control's documentation in PDF format)
*Added: The Images method supports the Microsoft ImageList ( mscomctl.ocx, MSComctlLib.ImageList type) object directly. Shortly, you can define the control's images by calling Images(ImageList1.Object). The ImageList1.Object returns the object of MSComctlLib.ImageList type. The Microsoft ImageList object is available for /COM on x86 and x64 machines (starting from Access 2016)
*Fixed: The "Do you want to save changes to the design of form ''? Yes, No, Cancel" message occurs in MS Access, every time the form is closed in design mode

11.0.0.2 Jul 24, 2019
*Fixed: Prevents showing the "This application is about to initialize ActiveX controls that might be unsafe. If you trust the source of this file, select OK and the controls will be initialized using your current workspace settings." warning message while the control is running into MS Office forms or user-forms.

11.0.0.1 Jun 20, 2018
*NEW:   Ability to executes x-script code ( including events ), from a string, file or a safe array of bytes. This feature allows you to load the control's visual appearance and behavior, without having to write any line of code. The x-script code can save EBNs, icons, pictures into BASE64 encoded strings, and so everything can be put into a single file, that should be invoked by AttachTemplate method. This feature allows you to run any x-script code for any configuration of the component (/COM, /NET or /WPF). 
*Added: AttachTemplate method executes the giving x-script code, and attach events if found. The x-script code can contain handle keyword that defines a handler for the specified event. For instance, the AttachTemplate("handle Click() { print(Version) }") sends the control's Version property to the debugger for display. All you need is to open the DebugView tool, and click the control.
*Added: The control's Template page supports AttachTemplate so you can assign x-script code ( including events )  in design mode, and so the control's visual appearance and behavior is changed once the control is created at runtime (/COM version only). 

10.0.0.1 Nov 13, 2017
*NEW:   Display a placeholder for missing icons, images in HTML captions.
*Added: The Key parameter of the HTMLPicture property is case insensitive, so you can display the picture using the insensitive key. For instance, <img>picA</img> is equivalent with <img>pica</img>, or <img>PICA</img> and so on.
*Added: The HTML caption shows a missing image placeholder for images whose source is missing. The missing placeholder displays the index of the icon being missing, or the key of the HTML picture being missing. 
*Added: The Version property includes the SpecialBuild number of the assembly so it provides information like Major.Minor.Build.Revison.SpecialBuild.Type...

9.0.0.1 Aug 02, 2017
*Fixed: An ICO file shows as 18x18 instead of 16x16 pixels if it is loaded using the HTMLPicture method.
*Fixed: Prevents showing the control's view in design mode, while running on FORTH system ( /COM version )
*Fixed: Prevents a memory leak when loading icons, pictures, from BASE64 encoded strings (Images method, HTMLPicture picture).
*Fixed: Prevents "Do you want to save ..." / "Save changes...' input box, when the user opens the form in design mode, and close it.

8.0.0.2 May 25, 2015
*Added: The HTML tags are case insensitive, so the < b > is equivalent with < B >
*Added: </solidline>, </upline>, </dotline> HTML tags ends the solid, up or dotted line
*Fixed: The parts of the line with different fonts in the HTML caption are vertically aligned ( instead aligning to the font's baseline ) if the line displays a picture or an icon using the <img> HTML tag.
*Fixed: The last italic character of a HTML caption may be shown as clipped

8.0.0.1 Mar 09, 2015
*NEW:   Subscript and Superscript implementation in HTML captions, using the <off> HTML tag
*Added: <off>, </off> built-in HTML tags defines the vertical offset to display the element, relative to the current position. This tag is inheritable. The <off pixels>, where, pixels indicates the vertical offset to be applied ). For instance, the following text displays a text with Subscript and Superscript such as: "Text <off 4>with subscript</off> <off -4>and superscript</off> support"
*Added: The <fgcolor=0000FF> and <fgcolor FF>, or <bgcolor=00FF00> and <bgcolor FF00>, so no = or full 6 hexa-digits are required to define the color to be applied
*Added: Prevents showing the ,.;!?'")}] characters at the beginning of a new line, when html text is word-wrapping.
*Fixed: The <font> HTML tag is not overwritten when using inside another <font> tag

7.0.0.1 Apr 22, 2014
*NEW:   Windows 8.1 64-bit compatibility
*Added: The /COM 64-bit version is compatible with Microsoft Office Applications: Excel 2013, Access 2013,...
*Fixed: MS Access plays a beep, when the user presses the Backspace key while the control has the focus.
*Fixed: In MS Access, can't use the CTRL+F4 key to close the current form.
*Fixed: "Visual C++ Runtime Error!" occurs if using the <fgcolor> or <bgcolor> with no indicating the color. Correct is <fgcolor RRGGBB>, instead <fgcolor>

6.3.0.3 Feb 13, 2013
*Added: Ability to use or load PNG, TIFF or WMF picture on the control's background ( Picture property for /COM version ) , using the LoadPicture predefined function of the Template property. For instance, the [.Template = "Picture = LoadPicture(`E:\picture.png`)"] OR [.Picture = .ExecuteTemplate("loadpicture(`E:\picture.png`)")] loads the PNG picture on the control's background.
*Added: Increases the performance of parsing HTML captions.
*Added: The Template property may contain several commands separated by ; not only cariage returns.
*Fixed: On terminal-servers (citrix), CPU-consumption varying from 1-4%, if multiple instances of the control is opened in the same time ( Exontrol.CommentWindow )

6.3.0.2 Jan 10, 2013
*NEW:   PNG support for picture properties.
*Added: PNG, TIFF, EXIF or WMF image format support.
*Fixed: In MS Access, can't use the F2 key.
*Fixed: In MS Access, the control loses its data once the Visible property is set on False or when the control is hosted to a tab control, and user changes the pages.

6.3.0.1 Oct 05, 2012
*NEW:   New text decorations support for HTML captions, like outlined characters, shadow, ....
*Added: <gra>, </gra> built-in HTML tags define a gradient text ( the <gra> supports color, mode and blending, like <gra rrggbb;mode;blend>, where, rr/gg/bb represents the red/green/blue values of the ending color, 808080 if missing as gray, mode a value between 0 and 4, 1 if missing, and blend 0 or 1, 0 if missing )
*Added: <out>, </out> built-in HTML tags define a text to show with outlined characters ( the <out> supports color and width, like <out rrggbb;width>, where rr/gg/bb represents the red/green/blue values of the outline color, 808080 if missing as gray, width indicates the size of outline, 1 if missing.
*Added: <sha>, </sha> built-in HTML tags define a text with a shadow ( the <sha> supports color, width and offset, like <out rrggbb;width;offset>, where rr/gg/bb represents the red/green/blue values of the shadow color, 808080 if missing as gray, width indicates the size of shadow, 4 if missing, and offset indicates the offset from the origin to display the text's shadow, 2 if missing.

6.2.0.1 Dec 07, 2011
*Added: The Template or ExecuteTemplate properties may contain several commands separated by ; not only cariage returns.
*Added: The /COM version can be dropped to the eXPropertiesList control as an object.
*Fixed: Removes the tooltip's shadow if time to show the tooltip is less than 250 ms, as on Windows 7, the tooltip may be displayed slower.
*Fixed: Changing the ShowImageList property in design mode fails, if the component is hosted in a VC++ 2005, 2008 and 2010 application ( available for /COM only ).

6.1.0.2 Aug 30, 2011
*NEW:   Inheritance for HTML attributes on multiple line ( for instance, the < b > is inherited on multiple lines, until the < /b > tag is found)
*NEW:   The < font > or < img > can change the height of the HTML line, so HTML captions can display lines with different heights.
*Added: The HTML captions allow using not-nested elements to be used. (for instance the sequence "< b >1< s >23< /b >4< /s>" displays 123 in bold while the 234 are shown in strikeout )
*Added: The < c > HTML tag centers the line. Similar with < r > HTML tag.
*Fixed: Ignores the ending HTML tags, if they are not used previously ( for instance, the < /b > is not displayed in the sequence "ABC< /b >" )

6.1.0.1 June 20, 2011
*Added: Appearance.RenderType property specifies the way colored EBN objects are displayed on the component. For instance use the RenderType on -3, no color is applied, -2, for OR-color scheme, -1 for AND-color scheme, ( older EBN color schemes ). The RenderType property is 0 by default, which indicates an A-color scheme.
*Added: Shows the pictures in the control as grayed, if the Enabled property is False ( the control is disabled )
*Added: The eXPropertiesList control may browse the EBN objects, on color properties ( valid for /COM version ).
*Fixed: Extra characters are inserted in the next line if the breaking element is a picture that does not fit the current line.

6.0.0.3 Mar 28, 2011
*NEW:   Ability to specify any COLOR for the control's frame/border/appearance if using EBN objects.
*Added: The Appearance property may specify any color to apply the EBN object to define the control's border. In other words, you can define the color and the visual aspect of the control's border/appearance.
*Added: The Background(exToolTipAppearance) property may specify any color to apply to tooltip's EBN so the control's tooltip can be shown using different colors.
*Fixed: Ignores the ending HTML tags, if they are not used previously ( for instance, the < /b > is not displayed in the sequence "ABC< /b >" )

6.0.0.2 Jan 10, 2011
*NEW:   Ability to specify ANY color to an EBN object, so you can use one EBN object to display it in any nuance, without embossing the shape and look of the EBN ( including transparent regions, and so on )
*Added: Significant improvements for control's performance while using a large number of EBN objects.
*Added: The EBN can be displayed using ANY color ( not only FF for rgb ). For instance, 0x1A88A5D indicates that EBN with the identifier 1 is displaying in Air Force blue color (#5D8AA8).
*Fixed: Extra characters are inserted in the next line if the breaking element is a picture that does not fit the current line.

6.0.0.1 Nov 17, 2010
*NEW:   Inheritance for HTML attributes on multiple line ( for instance, the < b > is inherited on multiple lines, until the < /b > tag is found)
*NEW:   The < font > or < img > can change the height of the HTML line, so HTML captions can display lines with different heights.
*Added: The HTML captions allow using not-nested elements to be used. (for instance the sequence "< b >1< s >23< /b >4< /s>" displays 123 in bold while the 234 are shown in strikeout )
*Added: The < c > HTML tag centers the line. Similar with < r > HTML tag.

5.0.0.2 Aug 24, 2010
*NEW:   Ability to change the parameters passed by reference of the control's events for environments that does not support events with parameters by reference, such as uniPaas 1.5 (formerly known as eDeveloper), DBase, and so on
*Added: EventParam() property accesses a specified parameter of the current event. This property has effect only during an event, and can be used to change or retrieve a specified parameter of the current event
*Added: EventParam(-1) retrieves the number of parameters that can be accessed.
*Added: 64-bit support

5.0.0.1 Nov 05, 2009
*Added: Compatible with the Data Execution Prevention (DEP). (SpecialBuild:2450)
*Added: Changing the way the colors are being applied to EBN objects.
*Fixed: The IDE flickers when the component is placed on a form, due ShowImageList property that creates a hidden top-most window, to store the icons.
*Fixed: The MDI form requires an extra click to activate it, once a modeless dialog is closed. The dialog contains a VB6 UserControl that hosts the control. ATL3.0 BUG

4.0.0.4 October 10, 2007
*Added: ToolTipFont property specifies the tooltip's font.or from the cursor
*Added: ShowToolTip( ToolTip, Title, X, Y ) shows the tool
*Added: AnchorFromPoint(X,Y) retrieves the identifier of the anchor from the specified coordinates

4.0.0.3 June 25, 2007
*NEW:   Ability to insert <a> anchor elements in HTML captions.
*Added: <a id;options> (anchor) built-in HTML element is a piece of text or some other object (for example an image) which marks the beginning and/or the end of a hypertext link.
*Added: The AnchorClick( AnchorID, Options ) event notifies whether the user clicks an anchor HTML element.
*Added: FormatAnchor property specifies the visual effect for anchor elements.

4.0.0.2 April 30, 2007
*Added: <font face;size> built-in HTML tag that specifies the font and the size to draw a portion of text until </font> is found. 
*Added: ExecuteTemplate property retrieves a Variant value, instead of a String, so it can returns Objects too.
*Added: Adds more accurate icons when you drag files to the control's images panel
*Fixed: Tab characters display square characters

4.0.0.1 April 13, 2007
*NEW:   Ability to change the visual appearance of the control's borders using skins, including transparent areas or round borders too.
*Added: Appearance property specifies a predefined border for the control, or a color expression whose last 7 bits in the high significant byte of the value indicates the index of the skin in the Appearance collection, being displayed as control's borders. For instance, if the Appearance = 0x1000000, indicates that the first skin object in the Appearance collection defines the control's border.
*Added: Background(exToolTipAppearance) property specifies the visual appearance of the tooltip's borders. For instance, if the Background(exToolTipAppearance) = 0x2000000, indicates that the second skin object in the Appearance collection defines the tooltip's border. 
*Added: Background(exToolTipBackColor) property indicates the tooltip's background color, if this is not 0. By default, the system indicates the tooltip's background, while the Background(exToolTipBackColor) property is 0.
*Added: Background(exToolTipForeColor) property specifies the tooltip's foreground color, if this is not 0. By default, the system indicates the tooltip's foreground color, while the Background(exToolTipForeColor) property is 0.

3.0.0.2 February 13, 2007
*NEW:   Ability to load and display custom size pictures to HTML captions.
*Added: HTMLPicture property. Adds or replaces a picture being used in the HTML captions.
*Added: <img> built-in tag supports pictures. For instance, the <img>pic1</img> displays the pic1 picture being loaded using the HTMLPicture("pic1")

3.0.0.1 October 13, 2006
*NEW:   Customizable Windows XP Theme support
*NEW:   The Template supports CreateObject method to create new objects. This feature can be used by programming environments ( such as eDeveloper ) that do not accept working with particular objects.
*NEW:   The Template supports calling multiple properties in the same line using the . (dot) separator.
*Added: ExecuteTemplate property, runs a template and retrieves a value of the variable in the template.

2.0.0.4 January 27, 2006
*Added: Improvements to the Template editor.

2.0.0.3 November 22, 2005
*Added: <img>number[:width]</img> inserts an icon inside the cell's caption. The number indicates the index of the icon being inserted. The width is optional and indicates the width of the icon being inserted. Using the width option you can overwrite multiple icons getting a nice effect. By default, if the width field is missing, the width is 18 pixels. 

2.0.0.2 September 05, 2005
*NEW:   Ability to insert icons anywhere in the item's caption.
*Added: < img >...< /img > HTML tag indicates the index of icon being inserted in the item's caption. For instance, the < img >2< /img > displays the second icon in the item's caption.

2.0.0.1 June 19, 2005
*NEW:   Skinnable Interface support ( ability to apply a skin to any background part ) ( Check the VB\VC\...Template samples )
*Added: Appearance object. Defines a collection of skins.
*Added: VisualAppearance property. Specifies an object that defines the control's visual appearance.
*Added: Background property. Specifies a background color or a skin for different parts like drop down filter button, closing filter bar button and so on.

1.0.0.6 November 05, 2004
*Added: VB\UNICODE sample

1.0.0.5 October 25, 2004
*Added: Support for ALT keys.
*Added: The KeyCode parameter of KeyDown, KeyUp events passed by reference.
*Added: The KeyAscii parameter of KeyPress event passed by reference.

1.0.0.4 April 29, 2004
*Added: Displays the control's content in the VFP-IDE (design mode ).

1.0.0.3 February 06, 2004
*NEW:   Ability to load the control's Images collection using BASE64 encoded strings.
*Added: The Images method supports BASE64 encoded strings that holds a list of icons. 
*Added: Item.Picture property. Specifies the item's picture.

1.0.0.2 January 07, 2004
*Added: Item.Alignment property. Specifies the item's alignment.
*Added: ToolTipWidth property. Specifies the width of the tooltip window, in pixels.

1.0.0.1 August 25, 2003
* Initial Release