Group parent

Important

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 the Print support app design guide.

Property sheet pages can be grouped together by assigning them to a single group parent. You can create a group parent by calling CPSUI's ComPropSheet function with a CPSFUNC_INSERT_PSUIPAGE function code, and specifying PSUIPAGEINSERT_GROUP_PARENT as the Type member for an INSERTPSUIPAGE_INFO structure.

When a new group parent is created, a handle is returned. The handle can then be used as the hComPropSheet parameter to ComPropSheet, when adding or deleting property sheet pages.

Additionally, a group parent handle is received as the hComPropSheet member of the PROPSHEETUI_INFO structure that is received by an application's PFNPROPSHEETUI-typed callback function. If you don't create new group parents, all property sheet pages should be assigned to this one.

You can create additional group parents under each group parent that is created. The property sheet itself is considered to be the top-level group parent. If you do not explicitly create additional group parents, all added property sheet pages are assigned to the top-level parent.