PFNPROPSHEETUI 回呼函式 (compstui.h)

發行項
02/22/2024

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)

共用方式為