WM_PSD_PAGESETUPDLG
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