指定頁面的方法

重要

新式列印平臺是 Windows 與印表機通訊的慣用方法。 我們建議您使用Microsoft的 IPP 收件匣類別驅動程式，以及列印支援應用程式 （PSA），自定義 Windows 10 和 11 中的列印體驗，以進行印表機裝置開發。

如需詳細資訊，請參閱 新式列印平臺 和 列印支援應用程式設計指南。

應用程式可以使用三種方法中的任何一個，將屬性表頁面指定為 CPSUI。 下列每個方法都包含呼叫 CPSUI 的 ComPropSheet 函式，並指定其中一個 ComPropSheet 函式代碼。

• 提供 COMPROPSHEETUI 結構

  如果應用程式藉由將 COMPROPSHEETUI 結構傳遞至 ComPropSheet 來描述屬性表頁面，它可以：

  • 使用其中 一個 CPSUI 提供的頁面和範本 來指定印表機介面 DLL 可用於印表機屬性表的預先定義標準頁面類型。

  • 指定將出現在頁面上的一組使用者可 修改屬性表選項 。

  • 指定 CPSUI 會在用戶檢視或修改頁面選項時呼叫的頁面事件回呼函式。

• 提供 PROPSHEETPAGE 結構

  如果使用 COMPROPSHEETUI 結構時，無法使用通用（標準）對話框來建構頁面，則可以使用 PROPSHEETPAGE 結構來描述屬性表頁面。 印表機介面 DLL 通常不需要使用這個方法。

• 提供回呼函式

  應用程式可以傳遞 PFNPROPSHEETUI 型別回呼函式的位址 ComPropSheet，該函式會立即呼叫 CPSUI。 回調函式負責呼叫 ComPropSheet 本身，以建立屬性表頁面。

  列印後台處理程式會使用這個方法來通知 CPSUI 是否存在印表機介面 DLL 的 DrvDocumentPropertySheets 和 DrvDevicePropertySheets 函式。 同樣地，Unidrv 和 Pscript 驅動程式會使用 技術來通知 CPSUI 是否存在 IPrintOemUI：:D ocumentPropertySheets 和 IPrintOemUI：:D evicePropertySheets COM 方法的使用者介面外掛程式。

無論使用哪一種方法來指定新頁面，就必須將群組父句柄傳遞給 ComPropSheet 函式，將頁面指派給群組父系。