共用方式為


DrvDocumentPropertySheets 函式 (winddiui.h)

印表機介面 DLL 的 DrvDocumentPropertySheets 函式負責建立描述列印文件屬性的屬性表頁面。

語法

LONG DrvDocumentPropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

參數

[in, optional] pPSUIInfo

呼叫端提供的 PROPSHEETUI_INFO 結構的指標。 可為 NULL (請參閱下列一節)。

lParam

呼叫端提供的整數值,其相依於PROPSHEETUI_INFO結構之 Reason 成員的內容,如下表所列。

原因值 lParam 的定義
PROPSHEETUI_REASON_INIT DOCUMENTPROPERTYHEADER 結構的指標。
所有其他原因值 如需 PFNPROPSHEETUI 函式類型,請參閱 lParam 參數的描述。 (DOCUMENTPROPERTYHEADER 結構的位址包含在 PROPSHEETUI_INFO 結構的 lParamInit 成員中。

傳回值

如果 pPSUIInfo NULL,而且如果 lParam ->fMode 為零或 lParam ->pdmOutNULL,則此函式應該會傳回大小, 印表機 DEVMODEW 結構的位元組。 否則,函式的傳回值與 PFNPROPSHEETUI 函式類型之 ReturnValue 區段中所述的值相同。 如需詳細資訊,請參閱一節。

言論

所有 印表機介面 DLL 都必須提供 DrvDocumentPropertySheets 函式,這是 使用 PFNPROPSHEETUI 函式類型所定義的。 函式的目的是呼叫 ComPropSheet 函式,CPSUI提供,以指定包含列印文件使用者可修改屬性的屬性表頁面。

如果針對 pPSUIInfo 參數收到的值未 NULL,則 NT 型作系統列印後台處理程式會透過 CPSUI 間接呼叫函式。 適用下列規則:

  • 函式應該執行作業,如 PFNPROPSHEETUI 函式類型所述。

  • DOCUMENTPROPERTYHEADER 結構 fMode 成員中的旗標會指出要顯示的屬性表頁面,以及是否應該允許使用者修改檔的屬性。 唯一可以設定的旗標是DM_IN_PROMPT(或DM_PROMPT)、DM_ADVANCED、DM_NOPERMISSION和DM_OUT_BUFFER(或DM_COPY)。

如果針對 pPSUIInfo 參數收到的值 NULL,則列印後台處理程式會直接呼叫函式,而不需要通過 CPSUI。 在此情況下,lParam 參數包含 DOCUMENTPROPERTYHEADER 結構的位址,並套用下列規則:

  • 如果 DOCUMENTPROPERTYHEADER 結構 fMode 成員為零, 或者,如果相同結構的 pdmOut 成員 NULL,函式應該只會傳回印表機 DEVMODEW 結構的總大小,包括公用和私用結構成員,包括 DOCUMENTPROPERTYHEADER 結構的 cbOut 成員。

  • 如果 fMode DOCUMENTPROPERTYHEADER 結構的成員不是零,則函式應該執行 fMode 旗標 所指示的作業。 可能設定的唯一旗標是DM_IN_BUFFER(或DM_MODIFY),以及DM_OUT_BUFFER(或DM_COPY)。

要求

要求 價值
目標平臺 桌面
標頭 winddiui.h (包括 Winddiui.h)

另請參閱

DOCUMENTPROPERTYHEADER

DrvDevicePropertySheets

IPrintOemUI::D ocumentPropertySheets