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.
#define WM_USER 0x0400
#define WM_PSD_PAGESETUPDLG (WM_USER )
Parameters
-
wParam
-
The low-order word specifies a value that indicates the paper size. This value can be one of the DMPAPER_ values listed in the description of the structure. The high-order word specifies 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.
Value Meaning - 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) -
lParam
-
A pointer to a PAGESETUPDLG structure that contains information used to initialize the Page Setup dialog box.
Return value
If the hook procedure returns TRUE, the dialog box sends no more 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 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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for