Methoden zum Angeben von Seiten
Wichtig
Die Modern Print-Plattform ist die von Windows bevorzugte Methode zur Kommunikation mit Druckern. Wir empfehlen die Verwendung des Microsoft IPP-Treibers für die Posteingangsklasse zusammen mit Print Support Apps (PSA), um das Druckverhalten in Windows 10 und 11 für die Entwicklung von Druckergeräten anzupassen.
Weitere Informationen finden Sie unter Modern Print-Plattform und der Anleitung zum Design der Print-Support-App.
Eine Anwendung kann eine von drei Methoden verwenden, um Eigenschaftsseiten für CPSUI anzugeben. Bei jeder der folgenden Methoden wird die Funktion ComPropSheet von CPSUI aufgerufen, wobei einer der ComPropSheet Funktionscodes angegeben wird.
Übergabe einer COMPROPSHEETUI-Struktur
Wenn eine Anwendung eine Eigenschaftsseite beschreibt, indem sie eine COMPROPSHEETUI-Struktur an ComPropSheet übergibt, kann sie:
eine der von CPSUI bereitgestellten Seiten und Vorlagen verwenden, um einen vordefinierten Standardseitentyp anzugeben, den Druckerschnittstellen-DLLs für Eigenschaftsseiten von Druckern verwenden können.
Legen Sie eine Reihe von vom Benutzer änderbaren Eigenschaftsseitenoptionen fest, die auf der Seite erscheinen sollen.
Geben Sie eine Seitenereignis-Callback-Funktion an, die CPSUI aufruft, wenn ein Benutzer die Optionen der Seite anzeigt oder ändert.
Übergabe einer PROPSHEETPAGE-Struktur
Eine PROPSHEETPAGE-Struktur kann verwendet werden, um eine Eigenschaftsseite zu beschreiben, wenn die Seite nicht mit den allgemeinen (Standard-) Dialogen erstellt werden kann, die bei Verwendung einer COMPROPSHEETUI-Struktur verfügbar sind. Druckerschnittstellen-DLLs sollten diese Methode normalerweise nicht verwenden müssen.
Bereitstellen einer Callback-Funktion
Eine Anwendung kann ComPropSheet die Adresse einer PFNPROPSHEETUI getypten Callback-Funktion übergeben, die CPSUI sofort aufruft. Die Callback-Funktion ist für den Aufruf von ComPropSheet selbst verantwortlich, um Eigenschaftsseiten zu erstellen.
Der Druck-Spooler verwendet diese Methode, um CPSUI über die Existenz der Funktionen DrvDocumentPropertySheets und DrvDevicePropertySheets der Druckerschnittstellen-DLL zu informieren. Ebenso verwenden die Unidrv- und Pscript-Treiber diese Technik, um CPSUI über die Existenz von IPrintOemUI::DocumentPropertySheets und IPrintOemUI::DevicePropertySheets COM-Methoden in Benutzeroberflächen-Plugins zu informieren.
Unabhängig davon, welche Methode für die Angabe neuer Seiten verwendet wird, müssen die Seiten einer Gruppe übergeordnet zugewiesen werden, indem ein Handle für die Gruppe übergeordnet an die Funktion ComPropSheet übergeben wird.