CPSUI-Supplied Pages and Templates
Important
The modern print platform is Windows' preferred means of communicating with printers. We recommend that you use Microsoft's IPP inbox class driver, along with Print Support Apps (PSA), to customize the print experience in Windows 10 and 11 for printer device development.
For more information, see Modern print platform and the Print support app design guide.
CPSUI supplies a set of predefined property sheet pages, along with three page templates. Predefined property sheet pages include the following:
A set of three pages, with tab titles of Layout, Paper/Quality, and Advanced. These pages are meant to contain document properties for printers, and can be used for creating a property sheet from within a printer interface DLL's DrvDocumentPropertySheets function.
A single page, with a tab title of Advanced. Again, the page is meant to contain document properties for printers, and can be used for creating a property sheet from within a printer interface DLL's DrvDocumentPropertySheets function.
A single page, with a tab title of Device Settings. This page is meant to contain printer properties, and can be used for creating a property sheet from within a printer interface DLL's DrvDevicePropertySheets function.
A single, generic treeview page with no predefined title. Any CPSUI application can use this page.
To use a predefined page, an application must identify it using the pDlgPage member of a COMPROPSHEETUI structure.
CPSUI also supplies three predefined page templates. CPSUI uses these templates for creating its predefined pages. Applications can also use them. The templates consist of the following:
A treeview page template, which CPSUI uses to create the predefined Advanced and Device Settings pages. This template consists of a treeview control that contains a node for each property sheet option. A context menu is associated with each node of the tree. Each node's context menu provides the means by which a user can modify the option's value. CPSUI supplies a dialog box procedure for this template, which handles Windows messages for all the CPSUI-supported window controls.
Two multiple control templates, which CPSUI uses to create the predefined Layout and Paper/Quality pages. CPSUI supplies a dialog box procedure for this template, which handles Windows messages for all the CPSUI-supported window controls.
To use a predefined page template, an application must identify it using the DlgTemplateID member of a DLGPAGE structure.