CPSUI 提供的函式

重要

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

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

CPSUI 為應用程式提供下列兩個重要功能：

• CommonPropertySheetUI

  CommonPropertySheetUI 函式是 CPSUI 的進入點。 函式會建立和顯示屬性表頁面，然後允許用戶檢視和修改它們。

  當應用程式呼叫 CommonPropertySheetUI 時，它會提供描述要建立之頁面的頁面建立回呼位址。 CPSUI 會呼叫此回呼以取得頁面描述。 然後，它會顯示頁面，可讓應用程式使用者修改頁面中所包含的值，並使用頁面事件回呼將修改的值傳遞給應用程式。 在使用者按兩下 [確定] 或 [取消] 關閉屬性表之前，CommonPropertySheetUI 函式才會傳回。

  請注意，印表機介面 DLL 不會呼叫此函式;列印多任務緩衝處理程式會呼叫它。

• ComPropSheet

  ComPropSheet 函式是應用程式將屬性表頁面描述為 CPSUI 的方法，讓 CPSUI 可以建立並顯示它們。 CPSUI 應用程式會從頁面建立回呼內 呼叫此函式。 一般而言，頁面描述包含頁面事件回呼的指標，當應用程式使用者修改頁面值時，將會呼叫 CPSUI。

如需呼叫這些函式時的詳細描述，請參閱 搭配印表機驅動程式使用 CPSUI。

另外兩個 CPUSUI 提供的函式 SetCPSUIUserData 和 GetCPSUIUserData 可供應用程式提供的對話框程式用來儲存和擷取應用程式提供的值。