FMTTEXT Mnemonic - Insert Formatted Text into SYSPRINT Device
Syntax
'FMTTEXT'(x,y,w,h,align),text$
'FMTTEXT'(x,y,w,h,align)+text$
Description
For BBj-specific information, see FMTTEXT Mnemonic - Insert Formatted Text into SYSPRINT Device - BBj.
The 'FMTTEXT' mnemonic inserts the formatted contents of text$ in the SYSPRINT device.
Parameter |
Description |
x |
Horizontal location of the upper left corner of the print region, in inches. |
y |
Vertical location of the upper left corner of the print region, in inches. |
w |
Width of the print region, in inches. |
h |
Height of the print region, in inches. |
align |
Method of formatting the text. It can be any combination of the values contained in the table below. |
text$ |
Text to be formatted. |
Settings for the align Parameter
The following table identifies the settings for the align parameter:
Value |
Name |
Description |
DEC($0001$) |
CENTER |
Centers text horizontally. |
DEC($0002$) |
RIGHT |
Right-aligns text. |
DEC($0004$) |
VCENTER |
Centers text vertically. This value must be combined with SINGLELINE. |
DEC($0008$) |
BOTTOM |
Justifies the text to the bottom. This value must be combined with SINGLELINE. |
DEC($0010$) |
WORDBREAK |
Breaks lines between words that extend past the edge of the rectangle specified in the x, y, w, h parameters. |
DEC($0020$) |
SINGLELINE |
Displays text on a single line only. Carriage returns and linefeeds do not break the line. |
DEC($0040$) |
EXPANDTABS |
Expands tab characters (converts any embedded $09$ characters in the text to one or more spaces). The default number of space characters per tab is 8 unless the TABSTOP value is also used. |
DEC($xx80$) |
TABSTOP |
Indicates that a custom tabstop is defined in the high order byte. For example, DEC$(0480$) specifies 4 characters per tab. |
DEC($0100$) |
NOCLIP |
Draws without clipping. Using this setting reduces processing time. It cannot be used with the TABSTOP value. |
DEC($0200$) |
EXTERNALLEADING |
Includes the font external leading in line height. Normally, external leading is not included in the height of a line of text. Cannot be used with the TABSTOP value. |
DEC($0800$) |
NOPREFIX |
Turns off processing of prefix characters. Normally, 'FMTTEXT' interprets the mnemonic-prefix character "&" as a directive to underscore the character that follows, and the mnemonic-prefix characters "&&" as a directive to print a single "&." By specifying NOPREFIX, this processing is turned off. It cannot be used with the TABSTOP value. |