PFNPROPSHEETUI 回呼函式 (compstui.h)

PFNPROPSHEETUI 函式類型是由 CPSUI 應用程式使用， (包括列印機介面 DLL) 來定義 頁面建立回呼，這會指定要建立的屬性表頁面。

語法

PFNPROPSHEETUI Pfnpropsheetui;

LONG Pfnpropsheetui(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM lParam
)
{...}

參數

pPSUIInfo

CPSUI 提供的 PROPSHEETUI_INFO 結構的指標。

lParam

CPSUI 提供的整數值，取決於PROPSHEETUI_INFO結構之 Reason 成員的內容。 下列是有效值：

PROPSHEETUI_REASON_BEFORE_INIT

這個值是 Windows 8 的新手，只會提供給傳遞至 CommonPropertySheetUI 的原始 PFNPROPSHEETUI 參數。

PROPSHEETUI_REASON_DESTROY

如果使用者已選取屬性表的 [確定] 或 [取消] 按鈕，則 lParam 值為非零值。 否則，此值為零。

PROPSHEETUI_REASON_GET_ICON

lParam 值是PROPSHEETUI_GETICON_INFO結構的指標。

PROPSHEETUI_REASON_GET_INFO_HEADER

lParam 值是PROPSHEETUI_INFO_HEADER結構的指標。

PROPSHEETUI_REASON_INIT

如果 pfnPropSheetUI 參數指定回呼函式至 CommonPropertySheetUI，lParam 是傳遞至 CommonPropertySheetUI 的lParam 值。

如果使用具有 CPSUI ComPropSheet 函式的 CPSFUNC_ADD_PFNPROPSHEETUI 函式程式代碼指定回呼函式，則 lParam 是傳遞至 ComPropSheet 的 lParam2 值。

CPSUI 會將 lParam 值複製到函式PROPSHEETUI_INFO結構的 lParamInit 成員。

lParam 值不得位於應用程式的堆疊上。

PROPSHEETUI_REASON_SET_RESULT

lParam 值是SETRESULT_INFO 結構的指標。

傳回值

如果作業成功，函式應該會傳回一個 (或更新) 的值。 否則，它應該會傳回小於一的值。

傳回碼	Description
一或多個。	將會呼叫與目前頁面父系相關聯的 PFNPROPSHEETUI 函式。
小於 1。	不會呼叫與目前頁面父系相關聯的 PFNPROPSHEETUI 函式。

備註

使用 PFNPROPSHEETUI 函式類型指定的回呼函式是由使用 CPSUI 來管理自訂屬性表頁面的應用程式所提供。 當應用程式呼叫 CommonPropertySheetUI 函式時，必須指定一個這類回呼函式。 例如，當 NT 型作業系統列印後台處理程式呼叫 CPSUI 的 CommonPropertySheetUI 函式以支援其 DocumentProperties 或 PrinterProperties 函式時，多任務緩衝處理器會指定內部 PFNPROPSHEETUI 類型的回呼函式。

應用程式可以使用函式程式代碼CPSFUNC_ADD_PFNPROPSHEETUI呼叫 CPSUI 的 ComPropSheet 函式，來指定額外的 PFNPROPSHEETUI 型別回呼函式。 例如，NT型作業系統列印後台處理程式會執行此動作，以通知 CPSUI 印表機介面 DLL 的 DrvDocumentPropertySheets 和 DrvDevicePropertySheets 函 式是否存在。 同樣地，Microsoft 的 Unidrv 和 Pscript 驅動程式會使用這項技術來通知 CPSUI，指出使用者介面外掛程式中有 IPrintOemUI：:D ocumentPropertySheets 和 IPrintOemUI：:D evicePropertySheets 方法。

CPSUI 會呼叫每個 PFNPROPSHEETUI 型別回呼函式數次。 PROPSHEETUI_INFO 結構的 Reason 成員會規定函式應該執行的作業，如下所示：

規格需求

需求	值
目標平台	桌面
標頭	compstui.h (包含 Compstui.h)