Úprava stránky seznamu vlastností Driver-Supplied

Důležitý

Moderní tisková platforma je upřednostňovaná pro komunikaci s tiskárnami ve Windows. Doporučujeme použít ovladač třídy doručené pošty IPP od Microsoftu spolu s tiskovými podpůrnými aplikacemi (PSA) k přizpůsobení prostředí tisku ve Windows 10 a 11 pro vývoj zařízení tiskárny.

Další informace najdete v průvodci návrhem aplikace Podpora tisku.

Modul plug-in pro uživatelské rozhraní může upravit stránky listu vlastností dodávané Unidrv nebo Pscript5 implementací metody IPrintOemUI::CommonUIProp a funkce zpětného volání.

Modul plug-in uživatelského rozhraní používá metodu IPrintOemUI::CommonUIProp k určení sady položek možností, které může CPSUI přidat, odebrat nebo nahradit buď na stránce vlastností tiskárny Nastavení zařízení, nebo na stránkách vlastností dokumentu Rozložení, Papír/Kvalitaa Rozšířené.

Funkce zpětného volání typu OEMCUIPCALLBACKse používá ke zpracování uživatelských úprav přizpůsobených možností položek.

Přidávání položek volby

Modul plug-in uživatelského rozhraní musí popisovat nové položky možností umístěním těchto položek do pole struktur OPTITEM, které jsou dodány ovladačem. Knihovna DLL rozhraní tiskárny ovladače volá metodu IPrintOemUI::CommonUIProp modulu plug-in uživatelského rozhraní dvakrát. Při prvním zavolání metody by měla vrátit počet požadovaných struktur OPTITEM. Ovladač přiděluje prostor pro pole OPTITEM a popisuje pole ve struktuře OEMCUIPPARAM. Ovladač znovu volá IPrintOemUI::CommonUIProp a poskytne adresu struktury OEMCUIPPARAM, takže metoda může načíst struktury OPTITEM, které obsahují popisy možností.

odebrání položek z možností

Pokud chcete odebrat možnost z karty vlastností, kterou poskytuje Unidrv nebo Pscript5, může modul plug-in uživatelského rozhraní IPrintOemUI::CommonUIProp procházet pole struktur OPTITEM, na které odkazuje struktura OEMCUIPPARAM. U každé možnosti, kterou chcete odebrat z seznamu vlastností, můžete nastavit příznak OPTIF_HIDE struktury OPTITEM. (Všimněte si, že tato možnost ve skutečnosti neodebere; skryje možnost od uživatele, aby uživatel nemohl změnit výchozí hodnotu.)

Nahrazení položek možností

Pokud chcete nahradit možnost na stránce vlastností, kterou poskytuje Unidrv nebo Pscript, měli byste postupovat podle pokynů zobrazených v předchozí části Odebrání položek možností, abyste odstranili existující položku možnosti, a poté postupujte podle pokynů v předchozím oddílu Přidání položek možností, abyste vytvořili novou položku možnosti, která nahradí starou položku.

Řešení úprav přizpůsobených hodnot nastavení

Aby bylo možné zpracovávat úpravy uživatele u přizpůsobených položek možností, musíte zadat alespoň jednu funkci zpětného volání. Můžete zadat jednu funkci zpětného volání, která zpracovává možnosti pro seznam vlastností dokumentu i seznam vlastností tiskárny, nebo můžete pro každou z nich zadat samostatnou funkci. Tato zpětná volání jsou typu OEMCUIPCALLBACK.

Funkce zpětného volání je specifikována umístěním své adresy do struktury OEMCUIPPARAM. Modul plug-in uživatelského rozhraní obdrží adresu této struktury jako vstup do své metody IPrintOemUI::CommonUIProp.

Když uživatel otevře seznam vlastností tiskárny nebo seznam vlastností dokumentu a upraví možnosti, CPSUI zavolá knihovnu DLL rozhraní tiskárny ovladače. Tato knihovna DLL zpracovává hodnoty možností obsažené ve svých vlastních strukturách OPTITEM. Poté pro každý modul plug-in uživatelského rozhraní knihovna DLL tiskárny volá funkci zpětného volání typu OEMCUIPCALLBACK, která byla dříve určena IPrintOemUI::CommonUIProp.