Gets the color on the printer.
Restriction: This routine is not currently supported on UNIX platforms.
Syntax:
call "PC_PRINTER_GET_COLOR" using printer-handle
by value fore-or-back
by reference color-red
by reference color-green
by reference color-blue
returning status-code
Parameters:
|
Using call prototype (see
Key)
|
Picture
|
printer-handle
|
cblt-x4-comp5
|
pic x(4) comp-5.
|
fore-or-back
|
cblt-x2-comp5
|
pic x(2) comp-5.
|
color-red
|
cblt-x2-comp5
|
pic x(2) comp-5.
|
color-green
|
cblt-x2-comp5
|
pic x(2) comp-5.
|
color-blue
|
cblt-x2-comp5
|
pic x(2) comp-5.
|
status-code
|
See
Library Routines - Key
|
|
On Entry:
-
printer-handle
- The printer handle returned when the printer was opened.
-
fore-or-back
- Whether to get the foreground or background color:
1
|
Foreground
|
2
|
Background
|
On Exit:
-
color-red
- A value between 0 and 255, giving the intensity of red.
-
color-greem
- A value between 0 and 255, giving the intensity of green.
-
color-blue
- A value between 0 and 255, giving the intensity of blue.
-
status-code
- Printer status code:
0
|
Successful
|
3
|
Printer device not open
|
22
|
Failed to free bitmap
|
Comments:
You must open the printer before using this routine.
You can find out if your printer supports color by using the PC_PRINTER_INFO library routine.