|
'TEXT' |
Draw Text |
GUI Display/Printer
'TEXT'(x,y[,x,y],text$,[attrib$])
Where:
|
attrib$ |
Optional attribute string. Note:
|
|
& |
Underscore the character following the '&' (as in hot keys). |
|
B |
Bottom alignment of text. (added in PxPlus 2017) |
|
C |
Center text horizontally. |
|
E |
Truncate text if it extends beyond size specified and insert ellipsis (…) at the end. Note:
|
|
F |
Show focus lines around text. |
|
L |
Left alignment of text. (added in PxPlus 2017) |
|
M |
Middle alignment of text. (added in PxPlus 2017) |
|
N |
Numeric data alignment. |
|
R |
Right alignment of text. (added in PxPlus 2017) |
|
S |
Fills only the text background (not the whole region) with chosen background color. |
|
T |
Top alignment of text. (added in PxPlus 2017) |
|
W |
Word wrap. See Word Wrap Behavior. |
|
# |
Same as N. |
|
(*PDF* Only) Change the text into a hyperlink where URL is the destination and the style=inherit option may be applied. See Hyperlinks. Note:
| |
|
*TEXT |
Special text block printing modes designed to give programmer ability to easily print multiple lines of output to a printer. See Block Printing. |
text$
String expression.
x,y,x,y
Point coordinates for top left and (optionally) bottom right, in graphical units. Numeric expression.
Use 'TEXT' to draw (print) text in graphics mode, starting at the point set by the first x,y coordinates. Use graphical units or @X(col) and @Y(line) functions (see @X( ) / @Y( ) function) for the various coordinates. The 'TEXT' mnemonic uses current 'FONT' and color attributes (i.e. 'RED', 'BLUE').
Use the optional second set of x,y parameters to define the bottom right corner of a rectangular region for displaying the text. You can use the functions TXH( ) and TXW( ) to make sure the text fits the region.
print 'font'("MS Serif",-11)
print 'green','text'(240,420,"&Hello","&")
If you print using 'TEXT' with word wrap On, printing to either *WINPRT* and *PDF* will word wrap normal text (i.e. text containing spaces); however, only *PDF* (not *WINPRT*) will word wrap lengthy unbroken text that does not contain spaces.
If you print using 'TEXT' with word wrap Off, both *WINPRT* and *PDF* will always truncate text. If you print without using 'TEXT', text will not word wrap.
Text Hyperlinks
If using the LibHaru *PDF* interface, i.e. 'HP' is On, and you print to a *PDF* channel using 'TEXT' with the <URL> attribute, the text will become a hyperlink with URL as the destination. The text will be underlined and displayed in blue to distinguish it as hyperlink text unless the style=inherit option was specified with the URL. In that case, the current font and foreground color will determine the look of the hyperlink text.
PDF viewer applications will attempt to guess whether a URL is a Web link or a file link. To prevent the PDF viewer application from being incorrect, the recommendation is that you prefix Web links with http://, https:// or ftp:// and prefix file links with file:///.
If you are creating a file link and using the file:/// prefix, you must use an absolute path to the file. However, if you want to use a relative path to the file, do not use the file:/// prefix and just specify the relative path. For example, if the open PDF file is in the directory C:\myapp\reports and you want to link to another PDF file called abc.pdf located in C:\myapp\reports\2016, you need to specify the URL as 2016\abc.pdf.
Examples:
print (pdf_chan)'text'(240,420,"Google","C<http://www.google.com>")
print (pdf_chan)'text'(240,420,"Your Report","R<file:///c:/my_app/abc/report.pdf>")
print (1)'font'("Arial",-30,"I")
print (1)'F1'
print (pdf_chan)'text'(240,420,"Your Report","R<abc/report.pdf style=inherit>")
(Support for text hyperlinks in PDFs if using LibHaru was added in PxPlus 2018.)
(The style=inherit option was added in PxPlus 2019.)
PxPlus provides a special attribute string of "*TEXT" (or "*RTF") to print blocks of text with word wrap to *WINPRT* and *PDF* printed output (PDF output current only support *TEXT, not *RTF).
To use this Block print feature, the 'TEXT' mnemonic allows the attribute string to contain "*TEXT" (or "*RTF"):
'TEXT'(x1,y1,x2,y2, "<string>", "*TEXT")
'TEXT'(x1,y1,x2,y2, "<RTF string>", "*RTF")
This would take the string (simple text or RTF) and print it within the bounds of the region specified on the printer. If *RTF, the current font and color setting would be ignored. If "*TEXT", the assumption would be word wrap but use current font, colors, etc.
Should the space required to print the output exceed the size of the region specified, the system will set the internal FIN value of "BYTESLEFT" to a non-zero value, indicating how much of the data was not printed. If all the data was printed, this value will be set to 0 (zero).
By testing the value in BYTESLEFT, the application can determine that the output did overflow the region and can issue a print with the attribute string of "*MORE". When specifying *MORE, the system will automatically resume printing the text where it left off. In addition, the application does not need to send the text string again since the system will have already buffered the output data; thus the output text string can be left blank (this will improve system throughput).
Example:
Assuming that the string COMMENT$ has a long comment to be printed on a document and may potentially require multiple pages to output, the following logic could be used:
|
Sample Using "BYTELEFT" to Handle Page Overflow |
|
gosub PRINT_HEADER |
Block printing also returns the actual number of print lines that were used to print the data in the internal FIN value of "TEXTUSEDHEIGHT". This value can be used to determine the exact height of the data printed so that the application can determine where to resume printing at if it wants to print below the text.
Example:
A typical example of using these two fields would be in a form print program where you may have lines intermixed with comments where the comments may be varying in length RTF text:
|
Sample Invoice Print Routine with Variable Length RTF Comments |
|
max_line=40 |
(The 'TEXT' Block Printing capabilities were added in PxPlus v8.11.)