Elemento principal del grupo

Importante

La plataforma de impresión moderna es el medio preferido de Windows para comunicarse con impresoras. Se recomienda usar el controlador de clase de bandeja de entrada IPP de Microsoft, junto con aplicaciones de soporte técnico de impresión (PSA), para personalizar la experiencia de impresión en Windows 10 y 11 para el desarrollo de dispositivos de impresora.

Para obtener más información, consulte Plataforma de impresión moderna y la Guía de diseño de aplicaciones para compatibilidad con impresión.

Las páginas de hojas de propiedades se pueden agrupar asignándolas a un único elemento principal del grupo. Puede crear un elemento principal del grupo llamando a la función ComPropSheet de CPSUI con un código de función CPSFUNC_INSERT_PSUIPAGE y especificando PSUIPAGEINSERT_GROUP_PARENT como miembro Type para una estructura INSERTPSUIPAGE_INFO.

Cuando se crea un nuevo elemento de grupo principal, se devuelve un identificador. A continuación, el identificador se puede usar como parámetro hComPropSheet en ComPropSheet, al agregar o eliminar páginas de hojas de propiedades.

Además, se recibe un identificador de elemento principal de grupo como miembro hComPropSheet de la estructura PROPSHEETUI_INFO que recibe la función de devolución de llamada con tipo PFNPROPSHEETUI de una aplicación. Si no crea nuevos elementos principales de grupo, todas las páginas de hojas de propiedades deben asignarse a este.

Puede crear elementos principales de grupo adicionales en cada elemento principal del grupo que se crea. La propia hoja de propiedades se considera el elemento principal del grupo de nivel superior. Si no crea explícitamente elementos principales de grupo adicionales, todas las páginas de hojas de propiedades agregadas se asignan al elemento principal de nivel superior.