PC_PRINTER_LOAD_BMP
Loads a bitmap into memory ready for the PC_PRINTER_WRITE_BMP function.
Syntax:
call "PC_PRINTER_LOAD_BMP" using printer-handle
by reference bmpfilename
by reference bmp-id
returning status-code
Parameters:
|
Using call prototype (see Library Routines - Key) |
Picture (32-bit systems) |
printer-handle |
cblt-x4-comp5 |
pic x(4) comp-5. |
bmpfilename |
pic x(n). |
pic x(n). |
bmp-id |
cblt-x4-comp5 |
pic x(4) comp-5. |
status-code |
See Library Routines - Key |
On Entry:
printer-handle |
The printer handle returned when the printer was opened. |
bmpfilename |
The name of the bitmap to be loaded (the name should be terminated with a
null or space). |
On Exit:
bmp-id |
A unique identifier for the loaded bitmap. |
status-code |
Printer status code:
0 |
Successful |
3 |
Printer device not open |
18 |
Failed to load bitmap |
19 |
Invalid bitmap identifier | |
Comments:
This routine is available only in the Windows environment.
Example:
call "PC_PRINTER_LOAD_BMP" using printer-handle
by reference "mflogo.bmp" & x"0"
by reference bmp-id
returning printer-retcode.
See Also: