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

Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Commdlg.h (include Windows.h)

See also

Reference

PagePaintHook

PageSetupDlg

PAGESETUPDLG

WM_PSD_ENVSTAMPRECT

WM_PSD_FULLPAGERECT

WM_PSD_GREEKTEXTRECT

WM_PSD_MARGINRECT

WM_PSD_MINMARGINRECT

WM_PSD_YAFULLPAGERECT

Conceptual

Common Dialog Box Library