Export (0) Print
Expand All

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.

ValueMeaning
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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft