property ExPrint.Caption as String
Specifies the document's caption.

 TypeDescription 
   String A string expression that indicates the document's caption, that support built-in HTML tags like shown bellow.  

Use the Caption property to specify the printed document's caption. Use the CaptionAlignment property to align the caption in the header or footer of the printed page. Use the CaptionPosition property to specify whether the document's caption is displayed on the header or footer of the printed page. Use the ShowPageNumbers property to show or hide the page number filed. Use the ExtraCaption property to add extra captions to your document. Use the Font property to assign a different font for the caption printed on the document. Use the <br> to break lines in the caption, and so you can display multiple-lines captions. Use the Images/ReplaceIcon method to add new icons to the control. Use the HTMLPicture property to add custom sized pictures.

Starting from the version 15.0, the Caption property and Caption parameter of  ExtraCaption method supports expressions, that can defines the HTML caption of each page based on different fields such as index of the page, total number of pages, the index of the object being printed / previewed, the index of the page relative to the object being printed, and the number of relative pages. If the Caption's expression is not valid, the Caption itself is displayed as HTML, be replacing the <%page%> and <%count%> fields with the current page, and number of pages, as explained on the bottom of the this page.

The Caption property / parameter supports the following keywords:

This property/method supports predefined constants and operators/functions as described here.

For instance, Caption can be ( as a valid-expression ): 

For instance, Caption can be ( as a non-expression ): 

The following screen shot shows where he caption mat be displayed:

Currently, the Caption property may include the following built-in HTML elements:

Use the <br> to break the lines, use the <font> element to specify a new face for the font, or to change the size of the font.

Also the Caption property supports the following predefined values:

 

 


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