ALTER-PRINTER

Syntax

ALTER-PRINTER [POINT-SIZE={point_size_num_lit|_var}] [FONT-TYPE={font_type|txt_var}] [SYMBOL-SET={symbol_set_id|txt_var}] [FONT={font_int_lit|_var}] [PITCH={pitch_num_lit|_var}]

Description

Alters printer parameters at runtime.

You can place the ALTER-PRINTER command in any part of an SQR program except the SETUP section.

ALTER-PRINTER attempts to change the attributes of the current printer for the current report. If an attribute does not apply to the current printer, it is ignored. For example, ALTER-PRINTER is ignored if it specifies proportional fonts for a report printed on a line printer. When your program is creating multiple reports and the printer is shared by another report, the attributes are changed for that report as well.

Parameters

Parameter	Description
POINT-SIZE	Specifies the new font point size.
FONT-TYPE	Specifies the new font type. Values are PROPORTIONAL or FIXED.
SYMBOL-SET	Specifies the new symbol set identifier.
FONT	Specifies the new font as a number. (For example, font=3 for Courier and font=4 for Helvetica.)
PITCH	Specifies the new pitch in characters per inch. See the DECLARE-PRINTER arguments table for information about these arguments.

Example

Change the font and symbol set for the current printer:

alter-printer

font=4   ! Helvetica

symbol-set=12U   ! PC-850 Multilingual

If the output prints to a PostScript printer, the SYMBOL-SET argument is ignored; however, if the .spf file is kept (-KEEP) and later printed on an HP LaserJet, the symbol set 12U can be used.

See The DECLARE-PRINTER command and the -KEEP command-line flag