CPSUI-Supplied Funkcje
Ważny
Nowoczesna platforma drukowania jest preferowanym sposobem komunikacji z drukarkami w systemie Windows. Zalecamy używanie sterownika klasy skrzynki odbiorczej IPP firmy Microsoft wraz z aplikacjami do obsługi drukowania (PSA), aby dostosować środowisko drukowania w systemie Windows 10 i 11 na potrzeby opracowywania urządzeń drukarki.
Aby uzyskać więcej informacji, zobacz przewodnik projektowania aplikacji obsługi drukowania .
Procesor CPSUI udostępnia następujące dwie ważne funkcje do zastosowań:
-
Funkcja CommonPropertySheetUI jest punktem wejścia CPSUI. Funkcja powoduje tworzenie i wyświetlanie stron arkusza właściwości, a następnie umożliwia ich wyświetlanie i modyfikowanie przez użytkownika.
Gdy aplikacja wywołuje CommonPropertySheetUI, dostarcza adres wywołania zwrotnego tworzenia strony opisujący strony do utworzenia. CPSUI wywołuje wywołanie zwrotne, aby uzyskać opisy stron. Następnie wyświetla strony, umożliwia użytkownikowi aplikacji modyfikowanie wartości zawartych na stronie oraz przekazuje zmodyfikowane wartości do aplikacji za pomocą wywołań zwrotnych zdarzeń strony . Funkcja CommonPropertySheetUI nie zwraca się, dopóki użytkownik nie odrzuci arkusza właściwości, klikając pozycję OK lub Anuluj.
Należy pamiętać, że biblioteki DLL interfejsu drukarki nie wywołują tej funkcji; jest wywoływana przez bufor wydruku.
-
Funkcja ComPropSheet to metoda, za pomocą której aplikacje opisują strony arkusza właściwości dla CPSUI, aby CPSUI mógł je tworzyć i wyświetlać. Aplikacje CPSUI wywołują tę funkcję podczas wywołań zwrotnych tworzenia strony . Zazwyczaj opis strony zawiera wskaźnik do wywołania zwrotnego zdarzenia strony, który CPSUI wywoła, gdy użytkownik aplikacji modyfikuje wartości strony.
Aby uzyskać szczegółowy opis, kiedy te funkcje są wywoływane, zobacz Using CPSUI with Printer Drivers.
Dwie dodatkowe funkcje dostarczone przez CPSUI, SetCPSUIUserData i GetCPSUIUserData, mogą być używane przez procedury okna dialogowego dostarczone przez aplikację do przechowywania i pobierania wartości dostarczonych przez aplikację.