IPrintOemUI：:D ocumentPropertySheets 方法 (prcomoem.h)

發行項
02/26/2024

方法 IPrintOemUI::DocumentPropertySheets 可讓使用者介面外掛程式將新頁面附加至印表機裝置的檔屬性表。

語法

HRESULT DocumentPropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

參數

pPSUIInfo

呼叫端提供的 PROPSHEETUI_INFO結構的指標。

lParam

呼叫端提供的值，取決於 pPSUIInfo-->Reason 中的原因值。原因值可以是下列其中一個常數，這些常數定義於 compstui.h 中。如需這些常數的詳細資訊，請參閱 PFNPROPSHEETUI 函式類型中的一節和 lParam 參數描述。

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

傳回值

傳回值取決於PROPSHEETUI_INFO結構 之 Reason 成員的內容。如需詳細資訊，請參閱 DrvDocumentPropertySheets的描述。

備註

使用者介面外掛程式的 IPrintOemUI::DocumentPropertySheets 方法會執行與使用者模式印表機介面 DLL 所匯出之 DrvDocumentPropertySheets 函式相同的作業類型。這兩個函式都有相同的輸入參數。

如果您提供使用者介面外掛程式， IPrintOemUI::DocumentPropertySheets 則會在呼叫驅動程式的 DrvDocumentPropertySheets 函式之後呼叫方法。

呼叫時IPrintOemUI::DocumentPropertySheets，PROPSHEETUI_INFO 結構的 lParamInit 成員包含 OEMUIPSPARAM 結構的位址。

如果您實作此方法，通常也會提供 _CPSUICALLBACK型別回呼函式來處理使用者修改。此回呼函式必須呼叫 IPrintOemDriverUI：:D rvUpdateUISetting ，以在修改與使用者介面設定相關聯的值時通知驅動程式，如果值儲存在驅動程式的 DEVMODEW 結構中， (而不是外掛程式的私人 DEVMODEW 成員 ) 或登錄機碼中。

如果 IPrintOemUI::DocumentPropertySheets 方法是由多個使用者介面外掛程式匯出，則會依指定外掛程式安裝的順序呼叫方法。

如果一個使用者介面外掛程式支援數個印表機模型，而且如果您只想要針對其中一些模型顯示新頁面， IPrintOemUI::DocumentPropertySheets 則方法應該只提供成功傳回值，而不需要頁面的模型實際新增頁面。

如需建立及安裝使用者介面外掛程式的詳細資訊，請參閱自定義 Microsoft 的印表機驅動程式。