Métodos para especificar páginas
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.
Una aplicación puede usar cualquiera de los tres métodos para especificar páginas de hoja de propiedades en CPSUI. Cada uno de los métodos siguientes implica llamar a la función ComPropSheet de CPSUI, especificando uno de los 5códigos de función ComPropSheet.
Aprovisionamiento de una estructura COMPROPSHEETUI
Si una aplicación describe una página de hojas de propiedades pasando una estructura COMPROPSHEETUI a ComPropSheet, puede:
Usar una de las páginas y plantillas proporcionadas por CPSUI para especificar un tipo de página estándar predefinido que los archivos DLL de interfaz de impresora pueden usar para las hojas de propiedades de la impresora.
Especificar un conjunto de opciones de hoja de propiedades modificables por el usuario que aparecerán en la página.
Especificar una función de devolución de llamada de evento de página a la que CPSUI llamará cuando un usuario consulte o modifique las opciones de la página.
Proporcionar una estructura PROPSHEETPAGE
Se puede usar una estructura PROPSHEETPAGE para describir una página de hojas de propiedades, si la página no se puede construir mediante los cuadros de diálogo comunes (estándar) disponibles cuando se usa una estructura COMPROPSHEETUI. Normalmente, los archivos DLL de la interfaz de impresora no deben necesitar usar este método.
Aprovisionamiento de una función de devolución de llamada
Una aplicación puede pasar ComPropSheet a la dirección de una función de devolución de llamada con tipo PFNPROPSHEETUI, a la que CPSUI llama inmediatamente. La función de devolución de llamada es responsable de llamar a ComPropSheet para crear páginas de hoja de propiedades.
El administrador de trabajos de impresión usa este método para informar a CPSUI de la existencia de las funciones DrvDocumentPropertySheets y DrvDevicePropertySheets del DLL de la interfaz de impresora. Del mismo modo, los controladores Unidrv y Pscript usan la técnica para informar a CPSUI de la existencia de los métodos COM IPrintOemUI::DocumentPropertySheets y IPrintOemUI::DevicePropertySheets en complementos de interfaz de usuario.
Independientemente del método usado para especificar páginas nuevas, las páginas deben asignarse a un elemento principal de grupo pasando un identificador de elemento principal de grupo a la función ComPropSheet.