property Surface.ToolBarHTMLPicture(Key as String) as Variant
Adds or replaces a picture in toolbar's HTML captions.

TypeDescription
Key as String A String expression that indicates the key of the picture being added or replaced. If the Key property is Empty string, the entire collection of pictures is cleared.
Variant The HTMLPicture specifies the picture being associated to a key. It can be one of the followings:
  • a string expression that indicates the path to the picture file, being loaded.
  • a string expression that indicates the base64 encoded string that holds a picture object, Use the eximages tool to save your picture as base64 encoded format.
  • A Picture object that indicates the picture being added or replaced. ( A Picture object implements IPicture interface ),

If empty, the picture being associated to a key is removed. If the key already exists the new picture is replaced. If the key is not empty, and it doesn't not exist a new picture is added.

By default, the ToolBarHTMLPicture collection is empty. The ToolBarHTMLPicture property handles a collection of custom size picture being displayed in the HTML captions, using the <img> tags. Use the ToolBarHTMLPicture property to add new pictures to be used in HTML captions. For instance, the ToolBarHTMLPicture("pic1") = "c:\winnt\zapotec.bmp", loads the zapotec picture and associates the pic1 key to it. Any "<img>pic1</img>" sequence in HTML captions, displays the pic1 picture. On return, the ToolBarHTMLPicture property retrieves a Picture object ( this implements the IPictureDisp interface ). The ToolBarImages method specifies the list of 16x16 icons to be displayed on the control's toolbar. The ToolBarCaption property specifies the caption of the button ( including icons, picture and so on ).