<< Click to Display Table of Contents >> VPE_PRINT |
[Windows platform only]
Is sent to inform the application about the several stages during the printing process.
VPE_PRINT
WPARAM wParam
LPARAM lParam
Parameters:
wParam
Action |
Value |
Comment |
PRINT_MSG_ABORT |
0 |
User aborted while printing |
PRINT_MSG_START |
1 |
Print started |
PRINT_MSG_END |
2 |
Print ended |
PRINT_MSG_SETUPABORT |
3 |
User aborted Setup-Dialog |
PRINT_MSG_SETUPSTART |
4 |
Setup-Dialog started |
PRINT_MSG_SETUPEND |
5 |
Setup-Dialog ended |
lParam
contains the document-handle, so you can determine which document has sent the message
Remarks:
Do not call VpeCloseDoc() when processing this event. You would terminate a module that is working.
Your application should return PRINT_ACTION_OK (zero) if it processes this message, except for wParam = PRINT_MSG_SETUPSTART, where your application may return in addition PRINT_ACTION_ABORT (= 1) to abort the print job. PRINT_MSG_SETUPSTART is sent, when the user clicked the print button in the preview (or pushed the corresponding key). You have the option to abort the job, for you can then create and print internally a new document which is completely different to the preview.
Another use for the PRINT_MSG_SETUPSTART message is, to pre-initialize the Device Control Properties at this stage, before the printer setup dialog will be shown to the user.