The WM_PSD_PAGESETUPDLG message notifies a PagePaintHook hook procedure that the Page Setup dialog box is about to draw the contents of the sample page. The hook procedure can use this message to carry out initialization tasks related to drawing the contents of the sample page.
WM_PSD_PAGESETUPDLG
wPaper = LOWORD(wParam); // paper-size flag
wFlags = HIWORD(wParam); // paper-orientation flag
lppsd = (LPPAGESETUPDLG) lParam; // dialog box information
Parameters
wPaper
Value of the low-order word of wParam. Specifies a value that indicates the paper size. This value can be one of the DMPAPER_ values listed in the description of the DEVMODE structure.
wFlags
Value of the high-order word of wParam. Indicates the orientation of the paper or envelope, and whether the printer is a dot matrix or HPPCL (Hewlett Packard Printer Control Language) device. This parameter can be one of the following values:
| 0x0001 | Paper in landscape mode (dot matrix) |
| 0x0003 | Paper in landscape mode (HPPCL) |
| 0x0005 | Paper in portrait mode (dot matrix) |
| 0x0007 | Paper in portrait mode (HPPCL) |
| 0x000b | Envelope in landscape mode (HPPCL) |
| 0x000d | Envelope in portrait mode (dot matrix) |
| 0x0019 | Envelope in landscape mode (dot matrix) |
| 0x001f | Envelope in portrait mode (HPPCL) |
lppsd
Value of lParam. Points to a PAGESETUPDLG structure that contains information used to initialize the Page Setup dialog box.
Return Values
If the hook procedure returns TRUE, the dialog box sends no more WM_PSD* messages and does not draw in the sample page until the next time the system needs to redraw the sample page.
If the hook procedure returns FALSE, the dialog box sends the remaining messages of the drawing sequence.
Remarks
The Page Setup dialog box includes an image of a sample page that shows how the user's selections affect the appearance of the printed output. When you call the PageSetupDlg function, you can provide a PagePaintHook hook procedure to customize the appearance of the sample page. Whenever the dialog box is about to draw the contents of the sample page, the dialog box sends a sequence of WM_PSD* messages to the hook procedure.
The first three messages of a drawing sequence (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT, or WM_PSD_MINMARGINRECT) provide information that the hook procedure can use to draw the contents of the sample page. The remaining messages (WM_PSD_MARGINRECT, WM_PSD_GREEKTEXTRECT, WM_PSD_ENVSTAMPRECT, WM_PSD_YAFULLPAGERECT) notify the hook procedure that the dialog box is about to draw a specific portion of the sample page. This allows the hook procedure to selectively draw portions of the sample page.
See Also
DEVMODE, PagePaintHook, PageSetupDlg, PAGESETUPDLG, WM_PSD_ENVSTAMPRECT, WM_PSD_FULLPAGERECT, WM_PSD_GREEKTEXTRECT, WM_PSD_MARGINRECT, WM_PSD_MINMARGINRECT, WM_PSD_YAFULLPAGERECT