CPSUI-Supplied Functions

Belangrijk

Het moderne afdrukplatform is de voorkeursmiddel van Windows om te communiceren met printers. U wordt aangeraden de IPP-inboxclassdriver van Microsoft te gebruiken, samen met PSA (Print Support Apps), om de afdrukervaring in Windows 10 en 11 aan te passen en te optimaliseren voor de ontwikkeling van printerapparaten.

Raadpleeg de ontwerp handleiding voor de print support appvoor meer informatie.

CPSUI biedt de volgende twee belangrijke functies voor toepassingen:

• CommonPropertySheetUI

  De CommonPropertySheetUI functie is het toegangspunt van CPSUI. De functie zorgt ervoor dat eigenschappenbladpagina's worden gemaakt en weergegeven, waarna ze kunnen worden bekeken en gewijzigd door een gebruiker.

  Wanneer een toepassing CommonPropertySheetUIaanroept, levert deze het adres van een callback voor het maken van pagina's waarin de pagina's worden beschreven die moeten worden gemaakt. CPSUI roept deze callback aan om de paginabeschrijvingen te verkrijgen. Vervolgens worden de pagina's weergegeven, kan de applicatiegebruiker waarden in de pagina wijzigen, en worden gewijzigde waarden aan de applicatie geleverd met behulp van callbacks voor pagina-gebeurtenissen. De functie CommonPropertySheetUI wordt pas geretourneerd als de gebruiker het eigenschappenvenster heeft gesloten door te klikken op OK of Annuleren.

  Houd er rekening mee dat DLL's van de printerinterface deze functie niet aanroepen; het wordt aangeroepen door de afdrukspooler.

• ComPropSheet

  De functie ComPropSheet is het middel waarmee toepassingen eigenschappenbladpagina's beschrijven aan CPSUI, zodat CPSUI deze kan maken en weergeven. CPSUI-toepassingen roepen deze functie aan vanuit callbackfuncties voor pagina-aanmaak . Een paginabeschrijving bevat doorgaans een aanwijzer naar een callback van pagina-gebeurtenissen, die CPSUI aanroept wanneer de gebruiker van de toepassing paginawaarden wijzigt.

Zie CPSUI gebruiken met printerstuurprogramma'svoor een gedetailleerde beschrijving van wanneer deze functies worden aangeroepen.

Twee extra functies die door CPSUI worden geleverd, SetCPSUIUserData en GetCPSUIUserData, kunnen worden gebruikt door door de toepassing geleverde dialoogvensterprocedures om een door de toepassing geleverde waarde op te slaan en op te halen.