PageSetupDlg
This function creates a Page Setup dialog box that enables the user to specify the attributes of a printed page. These attributes include the paper size and source, the page orientation—portrait or landscape—and the width of the page margins.
For Windows CE versions 2.10 and later, this function replaces the PrintDlg function.
BOOL PageSetupDlg(
LPPAGESETUPDLG lppsd);
Parameters
- lppsd
Long pointer to a PAGESETUPDLG structure that contains information used to initialize the dialog box. The structure receives information about the users selections when the function returns.
Return Values
If the user clicks the OK button, the return value is nonzero. The members of the PAGESETUPDLG structure pointed to by the lppsd parameter indicate the users selections.
If the user cancels or closes the Page Setup dialog box or an error occurs, the return value is zero. To get extended error information, use the CommDlgExtendedError function. One of the values shown in the following table is returned.
| CDERR_DIALOGFAILURE | CDERR_NOTEMPLATE |
| CDERR_FINDRESFAILURE | CDERR_REGISTRYFAILURE |
| CDERR_INITIALIZATION | CDERR_STRUCTSIZE |
| CDERR_LOADRESFAILURE | PDERR_CREATEDCFAILURE |
| CDERR_LOADSTRFAILURE | PDERR_NOPORTS |
| CDERR_LOCKRESFAILURE | PDERR_NOPRINTERS |
| CDERR_MEMALLOCFAILURE | PDERR_PRINTERNOTFOUND |
| CDERR_NOHINSTANCE | PDERR_RETDEFFAILURE |
| CDERR_NOHOOK |
For more information about these error values, see CommDlgExtendedError.
Remarks
The PageSetupDlg function is not supported for Palm-size PC version 2.0.
To create your own print dialog, you must use the dialog template. Items on this template cannot be deleted however, items can be hidden, modified, and added.
The PageSetupDlg function fills the DEVNAMES structure with byte offsets rather than the expected character offsets.
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.10 and later | Commdlg.h | Commdlg.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
CommDlgExtendedError, PrintDlg, PAGESETUPDLG, DEVNAMES
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.