Sdílet prostřednictvím


Použijte CPSUI s ovladači tiskárny

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 podpory tisku v1 a v2.

Spooler tisku společně s knihovnami DLL rozhraní tiskárnyvyužívá CPSUI k vytváření stránek listů vlastností pro tiskové dokumenty a zařízení tiskárny. Následující kroky jsou součástí, když aplikace (například Microsoft Word) zobrazí panel vlastností pro dokument k tisku:

  1. Aplikace volá funkci print spooleru DocumentProperties, kterou určuje tiskárnu, na které se má dokument vytisknout.

  2. Zařazování tisku volá funkci vstupního bodu CPSUI, CommonPropertySheetUI, určuje interní zpětně volanou funkci typu PFNPROPSHEETUI.

  3. Procesor CPSUI volá zpětnovazební funkci spooleru typu PFNPROPSHEETUI.

  4. Funkce zpětného volání typu PFNPROPSHEETUI zařazování volá funkci ComPropSheet (s kódem funkce CPSFUNC_ADD_PFNPROPSHEETUI) k oznámení CPSUI adresy funkce DrvDocumentPropertySheets příslušné knihovny DLL rozhraní tiskárny.

  5. CPSUI volá funkci DrvDocumentPropertySheets z knihovny DLL rozhraní tiskárny.

  6. Knihovna DLL rozhraní tiskárny volá funkci CPSUI DrvDocumentPropertySheets funkce ComPropSheet (obvykle s kódem funkce CPSFUNC_ADD_PCOMPROPSHEETUI) za účelem poskytnutí CPSUI popisů seznamu vlastností a zpětných volání událostí stránky .

  7. Funkce ComPropSheet v CPSUI volá CreatePropertySheetPage (popsané v dokumentaci k sadě Windows SDK) k vytvoření stránek vlastností určených knihovnou DLL rozhraní tiskárny. Procesor CPSUI pak zavolá List vlastností pro zobrazení stránek listu vlastností.

Následující diagram znázorňuje tyto kroky.

diagram znázorňující moduly, které jsou součástí zobrazení seznamu vlastností

Když uživatel aplikace prochází stránkami seznamu vlastností a upravuje hodnoty možností, operační systém upozorní CPSUI na události stránek a CPSUI následně volá zpětnou vazbu události stránek dodanou knihovnou DLL rozhraní tiskárny. Zpětné volání události stránky zpracovává události stránky a ukládá nově vybrané hodnoty možností interně podle potřeby.

Když uživatel zavře dialogové okno vlastností kliknutím na tlačítko OK nebo Zrušit, CPSUI zničí stránky a způsobí, že se funkce CommonPropertySheetUI vrátí do zařazování tisku, které pak vrátí kontrolu aplikaci.

Když aplikace místo tiskového dokumentu zobrazí vlastnostní list pro zařízení tiskárny, postupuje se stejně, s tou výjimkou, že aplikace volá funkci spooleru PrinterProperties a spooler má za úkol předat adresu funkce knihovny DLL rozhraní tiskárny DrvDevicePropertySheets do CPSUI.