WINPRINT-GET-PRINTER-INFO-EX

This operation code returns additional information about a particular printer, extending the functionality of WINPRINT-GET-PRINTER-INFO. It does not alter any of the current printer settings.

Usage

CALL "WIN$PRINTER"
    USING WINPRINT-GET-PRINTER-INFO-EX, WINPRINT-SELECTION
    GIVING RESULT

Parameters

WINPRINT-SELECTION Group item defined in "winprint.def" as follows:

01  WINPRINT-SELECTION.
   03 WINPRINT-NAME                    PIC X(80).
   03 WINPRINT-PORT                    PIC X(80).
   03 WINPRINT-DRIVER                  PIC X(80).
   03 WINPRINT-DRV-VERSION             SIGNED-INT.
   03 WINPRINT-NO-OF-PRINTERS          SIGNED-SHORT.
   03 WINPRINT-IS-DEFAULT              SIGNED-SHORT.
   03 WINPRINT-COPIES                  SIGNED-SHORT.
   03 WINPRINT-ORIENTATION             SIGNED-SHORT.
   03 WINPRINT-QUALITY                 SIGNED-SHORT.
   03 WINPRINT-CURR-ORIENTATION        SIGNED-SHORT.
   03 WINPRINT-CURR-COPIES             SIGNED-SHORT.
   03 WINPRINT-DUPLEX                  SIGNED-SHORT.
   03 WINPRINT-COLLATE                 SIGNED-SHORT.
   03 WINPRINT-COLOR                   SIGNED-SHORT.
   03 WINPRINT-CURR-DUPLEX             SIGNED-SHORT.
   03 WINPRINT-CURR-COLLATE            SIGNED-SHORT.
   03 WINPRINT-CURR-PAPERSIZE          SIGNED-SHORT.
   03 WINPRINT-CURR-TRAY               SIGNED-SHORT.
   03 WINPRINT-CURR-COLOR              SIGNED-SHORT.
   03 WINPRINT-JOB-TITLE               PIC X(80).

This group item has numerous conditional variables. See "winprint.def" for the complete list.

Return Values

This operation returns information about the currently selected printer using the values described in WINPRINT-GET-PRINTER and the values described below.

Description

The printer may be open or closed to perform these functions. There is no need to reset any of these functions. WINPRINT-SELECTION should be initialized prior to use. WINPRINT-GET-PRINTER-INFO-EX has all the same values as WINPRINT-GET-PRINTER-INFO plus the following additional values:

WINPRINT-DUPLEX - Determines if the currently selected printer supports duplex printing. If yes, the returned value is WPRT-HAS-DUPLEX.

WINPRINT-COLLATE - Determines if the currently selected printer supports collating. If yes, the returned value is WPRT-HAS-COLLATE.

WINPRINT-COLOR - Determines if the currently selected printer can print in color. If color printing is supported, the returned value is WPRT-HAS-COLOR.

WINPRINT-CURR-DUPLEX - Returns the current duplex setting of the printer. Possible values are: WPRT-SIMPLEX, WPRT-DUPLEX-VERTICAL, and WPRT-DUPLEX-HORIZONTAL.

WINPRINT-CURR-COLLATE - Determines if the collating feature of the currently selected printer is turned on or off.

WINPRINT-CURR-PAPERSIZE WINPRINT-CURR-TRAY - Returns the currently selected paper tray as defined in the printer driver. Values less than 16 should correspond to the PAPER-TRAYS table in "winprint.def." Values greater than 15 and less than 256 are considered undefined. Values greater than 255 are considered device specific.

Note: Values 12 and 13 are not defined in the PAPER-SIZES table in "winprint.def." This matches a similar gap the Windows API. Refer to "prndemox.cbl" for an example of how to compensate for these undefined values.

WINPRINT-CURR-COLOR – Determines if the printer is in the proper mode to print in color. If yes, WPRT-COLOR is returned. Monochromatic printers or color printers with color support disabled return WPRT-MONOCHROME.