Print-related properties of the HostOptions object

Applies To Objects

Description

The properties in this group affect how the screen display is printed with a Print Screen operation, or in Auto Print mode, or in Printer Controller mode. They do not affect the Print Screen toolbar button, or File menu command. They are equivalent to the options on the page Settings, Display, Printer.

Syntax

Unless noted, all print-related properties have the following syntax:

object.Property

Element	Description
Object	The HostOptions object.
Property	A print-related property.

Names and Descriptions of individual properties

BypassPrinterDriver

Returns or sets whether to send print jobs directly to the printer without interpretation by the printer driver. If TRUE, print jobs bypass the driver. This eliminates the form feed sent by the driver at the end of a print job. Although printer settings are lost, this option can be used safely in printer controller mode or if your print job is plain text.

PrintAutoFontSelect

Returns or sets whether to use fixed pitch font. If TRUE, use a fixed-pitch font. The font is selected from those supplied by the printer driver. The font that best fits 80 or 132 columns on the printed page is selected. If FALSE, the font is determined by the settings of the PrintFont, PrintFontStyle, and PrintFontSize properties.

PrintBackground

Returns or sets whether to print the current screen background. The default, FALSE, is not to print the background.

This property is available only in KEA! with Graphics, when running a DEC VT340 session.

PrintCloseIdle

Returns or sets the time to wait after receiving last piece of data before flushing buffered data and printing the page. The following values indicate the idle time. To set the property, use either a constant or a value. The "disabled" value indicates no automatic flush.

Constant	Value
xPRINTCLOSEIDLE2SECS	0
xPRINTCLOSEIDLE10SECS	1
xPRINTCLOSEIDLE30SECS	2
xPRINTCLOSEIDLE1MIN	3
xPRINTCLOSEIDLE2MIN	4
xPRINTCLOSEIDLE5MIN	5
xPRINTCLOSEIDLEDISABLED	6

PrintColors

Returns or sets whether to attempt color printing. If TRUE, colors are printed on a color printer, and a dithering technique used on a monochrome printer. The dithering technique depends on the driver's support. If FALSE, all non-white colors are printed as black.

This property is available only in KEA! with Graphics, when running a DEC VT340 session.

PrintEmulateANSI

Returns or sets whether to translate LA210 printer codes from the host to the printer type connected to the personal computer. Set this property TRUE if the host expects to send data to an ANSI printer in Printer Controller mode. This property is equivalent to the option "Controller mode emulates ANSI printer" on the Settings page: Display, Printer.

PrintExtent

Returns or sets how much of page memory will be printed when the host requests a print screen. The following values indicate how much of the page will be printed. To set the property, use either a constant or a value.

Constant	Value	Prints
xPRINTEXTENTPAGE	0	The entire page, even if only a portion of the page is viewed.
xPRINTEXTENTREGION	1	Only the scrolling region.
xPRINTEXTENTSELECTION	2	The selected area.
xPRINTEXTENTALLPAGES	3	All pages.

PrintFont

Returns or sets which font to use for printing. The font name is specified as a string. Setting this property only has effect if PrintAutoFontSelect is FALSE.

PrintFontSize

Returns or sets what size font to use for printing. The font size (points) is specified as a string. Setting this property only has effect if PrintAutoFontSelect is FALSE.

PrintFontStyle

Returns or sets what style font to use for printing. Typical strings are "Regular", "Bold", "Italic", "Bold Italic" Setting this property only has effect if PrintAutoFontSelect is FALSE.

PrintMode

Returns or sets how and when printing occurs. In most cases, the host sets these modes. The following values indicate the printing modes.

Constant	Value	Description
xPRINTMODENORMAL	0	Data appears on the screen, and is only printed when the user requests.
xPRINTMODEAUTO	1	Auto Print: Data appears both on the screen and the printer.
xPRINTMODECONTROLLER	2	Printer Controller mode: Data is sent directly from the host to a printer, without being displayed on the screen.

PrintReverseBlackWhite

Returns or sets whether to swap the darkest and brightest palete colors for printing. The default, TRUE, prints a conventional white-on-black screen as black on a white (paper) background.

This property is available only in KEA! with Graphics, when running a DEC VT340 session.

PrintTerminator

Returns or sets whether to send a form feed at end of the print operation. A form feed forces each print to a separate page. If TRUE, a form feed is appended.

PrintUseBitMap

Returns or sets whether to use bitmap printing method. If TRUE, the bitmap method is used, regardless of the state of properties GraphicsBitMap and GraphicsDisplayList.

This property is available only in KEA! with Graphics, when running a DEC VT340 session.