適用於印表機的UWP裝置應用程式

發行項
02/21/2024

重要

從 Windows 11 SDK （22000.1）版本開始，列印支援應用程式（PSA）是針對印表機開發 UWP 應用程式的建議方法。如需有關搭配列印裝置使用PSA的詳細資訊，請參閱列印支援應用程式設計指南和列印支援應用程式關聯主題。

下一節說明支援 v4 印表驅動程式模型的印表機 UWP 裝置應用程式。 UWP 裝置應用程式可以透過自定義的印表設定飛出視窗和通知支援，反白顯示印表機的特殊功能。 UWP 裝置應用程式也可以顯示印表機狀態、管理列印作業，以及執行印表機維護工作。若要深入瞭解一般 UWP 裝置應用程式，請參閱滿足 UWP 裝置應用程式。

若要使用下列主題中討論的 UWP 裝置應用程式功能，您的印表機必須支援 v4 印驅動程式模型。如需詳細資訊，請參閱開發 v4 列印驅動程式。

本節內容

主題	說明
如何顯示印表機狀態	本主題使用列印設定和列印通知範例的 C# 版本來示範如何查詢印表機狀態並顯示它。
如何自定義列印設定	本主題介紹進階列印設定飛出視窗，並示範列印設定和列印通知範例的 C# 版本如何以自定義飛出視窗取代預設飛出視窗。
使用列印通知	本主題介紹列印通知，並示範列印設定和列印通知範例的 C# 版本如何使用背景工作來回應列印通知。背景工作示範如何在本機應用程式數據存放區中儲存通知詳細數據、傳送快顯通知，以及更新磚和徽章。
如何管理列印作業	在 Windows 8.1 中，適用於印表機的 UWP 裝置應用程式可以管理列印作業。本主題使用列印作業管理和印表機維護範例的 C# 版本，示範如何建立列印作業的檢視、監視這些作業，以及在必要時取消作業。
如何進行印表機維護	在 Windows 8.1 中，UWP 裝置應用程式可以執行印表機維護，例如對齊列印頭和清潔嘴。本主題使用印表作業管理和印表機維護範例的 C# 版本來示範如何使用雙向通訊（Bidi）來執行這類裝置維護。
印表機擴充功能庫概觀	本主題介紹印表機延伸模組連結庫，這是一個連結庫，可協助裝置製造商為其印表機撰寫 UWP 裝置應用程式。

適用於印表機的 UWP 裝置應用程式的使用案例

如果您要：

醒目提示進階裝置功能，例如每頁列印多張相片。
提出裝置特定的建議。例如，您可以使用裝置應用程式來呈現影像管理選項，或提供設定和儲存印表機特定預設值的方法。

一般建議

呼叫 window.print（）之後，請檢查並處理來自 onClick 事件處理程式中應用程式 [列印] 按鈕的錯誤訊息。這可讓您的應用程式在沒有印表機可用的情況下中止列印要求。
如果列印失敗，請通知使用者，如果可能的話，請解釋失敗的原因。
如果您打算自定義列印體驗，請將此程式代碼分成列印隨附應用程式。這可讓您將程式代碼元件化，並簡化測試和偵錯程式。
請勿嘗試自定義您的列印體驗，以使用 V3 列印驅動程式。
請勿在自定義列印 UI 中公告列印裝置的配件。
不要顯示與 Microsoft Store 裝置應用程式叫用的原因無關的銷售專案。例如，當使用者按下通知，提醒他們筆墨不足之後，顯示要購買的列印墨盒是相關的。不過，在此相同案例中，也不適合嘗試銷售列印線或相片列印套件。
請勿將使用者重新導向至貴公司的網站，以取得更多產品銷售。
不要顯示與設定列印喜好設定工作無關的資訊。例如，請勿提供有關如何清除列印頭的資訊，或如何對齊及測試列印嘴。

範例

印表機的 UWP 裝置應用程式範例示範您可以在自己的 UWP 裝置應用程式中實作的印表機相關功能。每個範例也包含 PrinterExtensionLibrary 專案，您可以在自己的應用程式中重複使用，以協助進行印表機擴充功能。印表機延伸模組連結庫會包裝 v4 印表驅動程式中印表機延伸模組介面的 COM 實作。