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