IPrintOemUI::D ocumentPropertySheets 方法 (prcomoem.h)
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 函式相同的作業類型。 這兩個函式具有相同的輸入參數。
如果您提供使用者介面外掛程式,則會在呼叫驅動程式的 DrvDocumentPropertySheets 函式之後呼叫 IPrintOemUI::DocumentPropertySheets
方法。
呼叫 IPrintOemUI::DocumentPropertySheets
時,PROPSHEETUI_INFO 結構的 lParamInit 成員包含 OEMUIPSPARAM 結構的位址。
如果您實作此方法,通常也會提供 _CPSUICALLBACK型別回呼函式來處理使用者修改。 這個回呼函式必須呼叫 IPrintOemDriverUI::D rvUpdateUISetting,以在驅動程式的 DEVMODEW 結構中儲存值時通知驅動程式,或登錄機碼中。
如果 IPrintOemUI::DocumentPropertySheets
多個使用者介面外掛程式匯出方法,則會依外掛程式指定安裝的順序呼叫方法。
如果一個使用者介面外掛程式支援數個印表機模型,而且如果您只想要針對其中一些模型顯示新頁面,則 IPrintOemUI::DocumentPropertySheets
方法應該只針對不需要頁面的模型提供成功傳回值,而不會實際新增頁面。
如需建立及安裝使用者介面外掛程式的詳細資訊,請參閱 自定義Microsoft的印表機驅動程式。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | prcomoem.h (include Prcomoem.h, Compstui.h) |