CPSUI-bereitgestellte Funktionen
Wichtig
Die moderne Druckplattform ist die bevorzugte Methode von Windows für die 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 Moderne Druckplattform und im Designhandbuch für die Drucksupport-App.
CPSUI bietet die folgenden beiden wichtigen Funktionen für Anwendungen:
-
Die CommonPropertySheetUI-Funktion ist der Einstiegspunkt von CPSUI. Die Funktion bewirkt, dass Eigenschaftenblattseiten erstellt und angezeigt werden, und sie können dann von einem Benutzer angezeigt und geändert werden.
Wenn eine Anwendung CommonPropertySheetUI aufruft, stellt sie die Adresse eines Seitenerstellungsrückrufs bereit, der die zu erstellenden Seiten beschreibt. CPSUI ruft diesen Rückruf auf, um die Seitenbeschreibungen abzurufen. Anschließend werden die Seiten angezeigt, der Anwendungsbenutzer kann Werte ändern, die auf der Seite enthalten sind, und geänderte Werte mithilfe von Seitenereignisrückrufen an die Anwendung übermittelt werden. Die CommonPropertySheetUI-Funktion wird erst zurückgegeben, wenn der Benutzer das Eigenschaftenblatt geschlossen hat, indem er auf OK oder Abbrechen klickt.
Beachten Sie, dass DLLs der Druckerschnittstelle diese Funktion nicht aufrufen; sie wird vom Druckspooler aufgerufen.
-
Die ComPropSheet-Funktion ist die Möglichkeit, mit der Anwendungen Eigenschaftenblattseiten zu CPSUI beschreiben, sodass CPSUI sie erstellen und anzeigen kann. CPSUI-Anwendungen rufen diese Funktion innerhalb von Seitenerstellungsrückrufen auf. In der Regel enthält eine Seitenbeschreibung einen Zeiger auf einen Seitenereignisrückruf, den CPSUI aufruft, wenn der Anwendungsbenutzer Seitenwerte ändert.
Eine detaillierte Beschreibung, wann diese Funktionen aufgerufen werden, finden Sie unter Verwenden von CPSUI mit Druckertreibern.
Zwei zusätzliche CPSUI-bereitgestellte Funktionen, SetCPSUIUserData und GetCPSUIUserData, können von anwendungsspezifischen Dialogfeldprozeduren verwendet werden, um einen von der Anwendung bereitgestellten Wert zu speichern und abzurufen.