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, as a decimal integer.
Note:
The align parameter must be a decimal integer, so use the DEC() function for any combination of the values below.
| Value |
Description |
| $0001$ |
CENTER: Centers text horizontally. |
| $0002$ |
RIGHT: Right-aligns
text. |
| $0004$ |
VCENTER: Centers text
vertically. This value must be combined with SINGLELINE. |
| $0008$ |
BOTTOM: Justifies the
text to the bottom. This value must be combined with SINGLELINE. |
| $0010$ |
WORDBREAK: Breaks lines
between words that extend past the edge of the rectangle specified
in the x, y, w, and h parameters. |
| $0020$ |
SINGLELINE: Displays text
on a single line only. Carriage returns and linefeeds do not break
the line. |
| $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. |
| $xx80$ |
TABSTOP: Indicates that
a custom tabstop is defined in the high order byte. For example,
DEC$(0480$) specifies 4 characters per tab. |
| $0100$ |
NOCLIP: Draws without
clipping. Using this setting reduces processing time. It cannot
be used with the TABSTOP value. |
| $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. |
| $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. |
|
| text$ |
Text to be formatted. |
See Also
Mnemonics - Alphabetical
Listing
Mnemonics - Group Listing