funciones de CPSUI-Supplied

Importante

Se recomienda usar el controlador de clase de bandeja de entrada IPP de Microsoft, junto con las 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 la Guía de diseño de aplicaciones de soporte técnico de impresión.

CPSUI proporciona las dos funciones importantes siguientes para las aplicaciones:

• CommonPropertySheetUI

  La función CommonPropertySheetUI es el punto de entrada de CPSUI. La función hace que se creen y muestren las páginas de la hoja de propiedades y, a continuación, permite que un usuario las vea 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 devuelve hasta que el usuario haya descartado la hoja de propiedades haciendo clic en Aceptar o Cancelar.

  Tenga en cuenta que los archivos DLL de la interfaz de impresora no llaman a esta función; lo llama el administrador de trabajos de impresión.

• ComPropSheet

  La función ComPropSheet es el medio por el que las aplicaciones describen las páginas de la hoja de propiedades en CPSUI, de modo que CPSUI pueda crearlas y mostrarlas. Las aplicaciones CPSUI llaman a esta función desde 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.