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 結構的指標。

傳回值

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

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

言論

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

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

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

要求

要求	價值
目標平臺	桌面
標頭	compstui.h （包括 Compstui.h）