Modyfikowanie strony arkusza właściwości Driver-Supplied
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, zajrzyj do przewodnika projektowania aplikacji wsparcia druku .
Wtyczka interfejsu użytkownika może modyfikować strony arkusza właściwości dostarczone przez Unidrv lub Pscript5, implementując metodę IPrintOemUI::CommonUIProp oraz funkcję wywołania zwrotnego.
Wtyczka interfejsu użytkownika wykorzystuje metodę IPrintOemUI::CommonUIProp, aby określić zestaw elementów opcji, które CPSUI może dodać, usunąć lub zastąpić na stronie Ustawienia urządzenia arkusza właściwości drukarki albo na stronach Układ, Papier/Jakośćoraz Zaawansowane arkusza właściwości dokumentu.
Funkcja wywołania zwrotnego typu OEMCUIPCALLBACKsłuży do przetwarzania modyfikacji dokonanych przez użytkownika w dostosowanych elementach opcji.
dodawanie elementów opcji
Wtyczka interfejsu użytkownika musi opisywać nowe elementy opcji, umieszczając je w tablicy struktur OPTITEM dostarczonych przez sterownik. Biblioteka DLL interfejsu drukarki sterownika wywołuje metodę IPrintOemUI::CommonUIProp wtyczki interfejsu użytkownika dwa razy. Przy pierwszym wywołaniu metoda powinna zwrócić liczbę wymaganych struktur OPTITEM. Sterownik przydziela miejsce dla tablicy OPTITEM i opisuje tablicę w strukturze OEMCUIPPARAM. Sterownik wywołuje ponownie IPrintOemUI::CommonUIProp, podając adres struktury OEMCUIPPARAM, aby metoda mogła załadować struktury OPTITEM z opisami opcji.
usuwanie elementów opcji
Aby usunąć opcję ze strony arkusza właściwości dostarczonej przez Unidrv lub Pscript5, metoda IPrintOemUI::CommonUIProp wtyczki interfejsu użytkownika może przechodzić przez tablicę struktur OPTITEM, na które wskazuje struktura OEMCUIPPARAM. Dla każdej opcji, którą chcesz usunąć z arkusza właściwości, możesz ustawić flagę OPTIF_HIDE struktury OPTITEM. (Należy pamiętać, że nie powoduje to usunięcia opcji; powoduje ukrycie opcji od użytkownika, aby użytkownik nie mógł zmienić jego wartości domyślnej).
zastępowanie elementów opcji
Aby zastąpić opcję na stronie arkusza właściwości dostarczonej przez unidrv lub Pscript, należy postępować zgodnie z instrukcjami wyświetlanymi w poprzedniej sekcji Usuwanie elementów opcji, aby usunąć istniejący element opcji, a następnie postępuj zgodnie z instrukcjami w poprzedniej sekcji Dodawanie elementów opcji, aby utworzyć nowy element opcji, aby zastąpić stary.
Zarządzanie modyfikacjami dostosowanych wartości opcji
Aby przetworzyć modyfikacje użytkowników dotyczące spersonalizowanych elementów opcji, należy podać co najmniej jedną funkcję wywołania zwrotnego. Można określić jedną funkcję wywołania zwrotnego, która obsługuje opcje zarówno arkusza właściwości dokumentu, jak i arkusza właściwości drukarki, lub można określić oddzielną funkcję dla każdego z nich. Te wywołania zwrotne są typu OEMCUIPCALLBACK.
Funkcja wywołania zwrotnego jest określana przez umieszczenie adresu funkcji w strukturze OEMCUIPPARAM. Wtyczka interfejsu użytkownika odbiera adres tej struktury jako dane wejściowe do metody IPrintOemUI::CommonUIProp.
Gdy użytkownik otworzy arkusz właściwości drukarki lub arkusz właściwości dokumentu i modyfikuje opcje, CPSUI wywołuje bibliotekę DLL interfejsu drukarki sterownika drukarki. Ta biblioteka DLL przetwarza wartości opcji zawarte we własnych strukturach OPTITEM. Następnie, dla każdej wtyczki interfejsu użytkownika, biblioteka DLL interfejsu drukarki wywołuje funkcję zwrotną typu OEMCUIPCALLBACK, która została wcześniej określona przez IPrintOemUI::CommonUIProp.