CPSUI-Supplied Functions

Important

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 Print Support App v1 and v2 design guide (Przewodnik projektowania aplikacji do obsługi wydruku w wersji 1 i 2).

Procesor CPSUI udostępnia następujące dwie ważne funkcje do zastosowań:

• CommonPropertySheetUI

  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 element CommonPropertySheetUI, dostarcza adres wywołania zwrotnego tworzenia strony , który opisuje 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 przycisk OK lub Anuluj.

  Należy pamiętać, że biblioteki DLL interfejsu drukarki nie wywołują tej funkcji; jest wywoływana przez bufor wydruku.

• ComPropSheet

  Funkcja ComPropSheet to metoda, za pomocą której aplikacje opisują strony arkusza właściwości w procesorze CPSUI, dzięki czemu cpSUI może 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 dostarczane przez procesor CPSUI, SetCPSUIUserData i GetCPSUIUserData, mogą być używane przez procedury okna dialogowego dostarczone przez aplikację do przechowywania i pobierania wartości dostarczonej przez aplikację.