Funciones proporcionadas por CPSUI
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.
CPSUI proporciona las dos funciones importantes siguientes para las aplicaciones:
-
La función CommonPropertySheetUI es el punto de entrada de CPSUI. La función hace que se creen y muestren páginas de hojas de propiedades y, a continuación, permite que un usuario las consulte y modifique.
Cuando una aplicación llama a CommonPropertySheetUI, proporciona la dirección de una devolución de llamada de creación de páginas que describe las páginas que se van a crear. CPSUI llama a esta devolución de llamada para obtener las descripciones de la página. A continuación, muestra las páginas, permite al usuario de la aplicación modificar los valores contenidos en la página y entrega valores modificados a la aplicación mediante devoluciones de llamada de eventos de página. La función CommonPropertySheetUI no vuelve hasta que el usuario haya descartado la hoja de propiedades haciendo clic en Aceptar o Cancelar.
Tenga en cuenta que los archivos DLL de interfaz de impresora no llaman a esta función; la llama el administrador de trabajos de impresión.
-
La función ComPropSheet es el medio por el que las aplicaciones describen páginas de hoja de propiedades a CPSUI, de modo que CPSUI pueda crearlas y mostrarlas. Las aplicaciones CPSUI llaman a esta función desde las devoluciones de llamada de creación de páginas. Normalmente, una descripción de página incluye un puntero a una devolución de llamada de evento de página, a la que CPSUI llamará cuando el usuario de la aplicación modifique los valores de página.
Para obtener una descripción detallada de cuándo se llama a estas funciones, consulte Uso de CPSUI con controladores de impresora.
Dos funciones adicionales proporcionadas por CPSUI, SetCPSUIUserData y GetCPSUIUserData, se pueden usar mediante procedimientos de cuadro de diálogo proporcionados por la aplicación para almacenar y recuperar un valor proporcionado por la aplicación.