IPrintOemUI2：：HideStandardUI 方法 (prcomoem.h)

發行項
02/26/2024

方法 IPrintOemUI2::HideStandardUI 可讓使用者介面外掛程式指定是否應該顯示或隱藏標準屬性表。從 Microsoft Windows XP 開始，這個方法可由 Pscript5 使用者介面外掛程式實作。從 Windows Vista 開始，這個方法可由 Unidrv 使用者介面外掛程式實作。

語法

HRESULT HideStandardUI(
  DWORD dwMode
);

參數

dwMode

指定要隱藏的屬性表 UI 類型 -- 檔案屬性表或裝置屬性表。此參數應該設定為下列其中一個常數，其定義於 printoem.h：

值	意義
OEMCUIP_DOCPROP	隱藏標準檔案屬性表UI。
OEMCUIP_PRNPROP	隱藏標準裝置屬性表UI。

傳回值

成功時，此方法應該會傳回S_OK。否則，它應該會傳回E_NOTIMPL。如需詳細資訊，請參閱。

備註

Windows Vista for Pscript 5 和 Unidrv 外掛程式支援此方法，而且僅適用於 Pscript5 外掛程式的 Windows XP。

當 pPSUIInfo-->Reason 設定為 PROPSHEETUI_REASON_INIT時，在DrvDocumentPropertySheets 或DrvDevicePropertySheets DDIs 內，驅動程式會呼叫 IPrintOemUI2::HideStandardUI 方法來詢問 UI 外掛程式的使用者介面要求。這個方法可以透過下列四種方式之一回應：

隱藏標準檔案屬性表UI。
隱藏標準裝置屬性表UI。
隱藏所有標準屬性表UI。
請勿隱藏任何標準屬性表UI。

下表摘要說明 IPrintOemUI2::HideStandardUI 方法在每個情況中如何回應。

若要指出此回應...	IPrintOemUI2：：HideStandardUI 會傳回...
隱藏標準檔案屬性表UI。外掛程式會實作自己的文件屬性表UI。	如果 dwMode == OEMCUIP_DOCPROP，則傳回S_OK;否則會傳回E_NOTIMPL。
隱藏標準裝置屬性表UI。外掛程式會實作自己的裝置屬性表UI。	如果 dwMode == OEMCUIP_PRNPROP，則傳回S_OK;否則會傳回E_NOTIMPL。
隱藏所有標準屬性表UI。外掛程式會實作自己的文件屬性表和裝置屬性表 UI。	不論 dwMode 的值為何，都會傳回S_OK。
顯示所有標準屬性表UI。	不論 dwMode 的值為何，都會傳回E_NOTIMPL。

IPrintOemUI2::HideStandardUI如果方法向驅動程式指出應該隱藏所有標準屬性表，驅動程式會省略對 compstui.dll (的呼叫，請參閱 Pscript 元件) 以新增標準屬性表。如果 IPrintOemUI2::HideStandardUI 傳回S_OK，UI 外掛程式必須實作至少一個自定義屬性表 UI。

當印表機安裝多個UI外掛程式時，驅動程式會依安裝的順序呼叫UI外掛程式，直到其中一個外掛程式傳回S_OK，或直到呼叫所有UI外掛程式，且不會傳回任何S_OK。先前的案例會向驅動程式指出應該隱藏標準屬性表 UI。後者的情況會向驅動程式指出應該顯示標準屬性表UI。