PRINTER-CONTROL-HANDLE attribute

(Windows only)

The default context for print jobs.

Data type:

INTEGER

Access:

Readable/Writeable

Applies to:

SESSION system handle

The print context is an integer identifier for a set of values that define a printer and setup for that printer in Windows. You can establish a print context using the Print dialog box. The SYSTEM-DIALOG PRINTER-SETUP statement allows you to display the Print dialog box and set a print context. This print context is used by the OUTPUT TO PRINTER statement to direct output to a printer.

If the PRINTER-CONTROL-HANDLE attribute contains zero (0) or the Unknown value (?), the print context is the default print context in Windows as set in the Windows Control Panel. You can assign any integer value to this attribute, but the result of the assignment will be to set the attribute value to 0 and to release any Windows resources related to the previous print context.