Prints the contents of the specified file, optionally displaying printer control, font, and progress indicator dialog boxes,
before commencing the print.
Restriction: This routine is not currently supported on UNIX platforms.
Syntax:
CALL "PC_PRINT_FILE" using filename
document-title
by value flags
by value window-handle
returning status-code
Parameters:
-
filename
- Group predefined as
cblt-printer-name containing:
01 cblt-printer-name typedef
03 cblt-pn-name-length cblt-x2-comp5 *> pic x(2) comp-5
03 cblt-pn-name pic x(n). *> pic x(n).
-
document-title
- Group predefined as
cblt-printer-name containing:
01 cblt-printer-name typedef
03 cblt-pn-name-length cblt-x2-comp5 *> pic x(2) comp-5
03 cblt-pn-name pic x(n). *> pic x(n).
-
flags
- Using call prototype (see
Key) : Numeric literal or cblt-x4-comp5.
- Picture: Numeric literal or pic x(4) comp-5.
-
window-handle
- Using call prototype (see
Key) : Numeric literal or cblt-x4-comp5.
- Picture: Numeric literal or pic x(4) comp-5.
-
status-code
- See
Library Routines - Key
On Entry:
-
filename
- The name of the file to be printed (null or space terminated)
-
document-title
- The title of the document to be printed
-
flags
- A set of bits to define printer options:
| bit 0
|
Display a printer control dialog to allow you to define the printer characteristics - cannot be used with bit 2 or bit 3
|
| bit 1
|
Display a font dialog box to allow you to define the default font for the document
|
| bit 2
|
Print in portrait orientation - cannot be used with bit 0 or bit 3
|
| bit 3
|
Print in landscape orientation - cannot be used with bit 0 or bit 2
|
| bit 4
|
Display a progress indicator dialog box
|
| bit 5
|
Directs raw output through the Windows spooler - only bit 0 can be used with this bit
|
-
window-handle
- Handle of parent window. The parent window is used as a reference for positioning dialog boxes. If
window-handle is 0 the dialog boxes will be positioned in a system dependent position on the screen.