_CPSUICALLBACK回调函数 (compstui.h)

_CPSUICALLBACK函数类型由 CPSUI 应用程序使用， (包括打印机接口 DLL) ，用于定义打算用作 CPSUI 消息处理程序的回调函数。

语法

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

参数

pCPSUICBParam

CPSUI 提供的指向 CPSUICBPARAM 结构的指针。

返回值

_CPSUICALLBACK类型的回调函数必须返回下表中列出的值之一。 每个值指示 CPSUI 应执行的操作。

返回代码	说明
CPSUICB_ACTION_ITEMS_APPLIED	CPSUICBPARAM 结构的 Reason 成员已设置为 CPSUICB_REASON_APPLYNOW，并且回调函数已成功处理当前选项值。
CPSUICB_ACTION_NO_APPLY_EXIT	CPSUICBPARAM 结构的 Reason 成员已设置为CPSUICB_REASON_APPLYNOW，但回调函数检测到选项值无效或不兼容。 回调函数必须显示一个对话框，告知用户问题。
CPSUICB_ACTION_NONE	CPSUI 无需执行任何操作。
CPSUICB_ACTION_OPTIF_CHANGED	回调函数在 OPTITEM 结构中设置了 OPTIF_CHANGED 标志，以指示所选选项已更改，或者另一个 OPTIF 前缀的标志已更改。
CPSUICB_ACTION_REINIT_ITEMS	回调函数在 OPTITEM 结构中设置了OPTIF_CHANGED标志，以指示关联的 OPTTYPE 或 OPTPARAM 结构的 Flags 或 pData 成员已更改。

注解

使用 _CPSUICALLBACK 函数类型指定的回调函数由使用 CPSUI 管理属性表页的应用程序提供。 如果其中一个回调函数与属性表页相关联，则当检测到用户活动 (（例如更改页面的控件焦点、修改选项值或单击“ 确定” ）) 时，CPSUI 将调用它。

_CPSUICALLBACK类型的回调函数通过将地址包含在 COMPROPSHEETUI 结构中分配给属性表页，该结构在函数代码CPSFUNC_ADD_PCOMPROPSHEETUI时传递给 CPSUI 的 ComPropSheet 函数。

此外，通过使用 EXTPUSH 结构，可以将回调函数分配给扩展的按钮。

调用其中一个回调函数时，它将接收指向 CPSUICBPARAM 结构的指针。 此结构描述页面的当前选项设置，并指示导致调用函数的用户事件。 回调函数负责验证和处理设置。 如果某个设置 (或) 设置的组合无效，它应显示一个对话框。 函数的返回值向 CPSUI 指示页面是否需要重新显示或重新初始化。

如果 DLGPAGE 结构的 DlgProc 成员指定应用程序提供的对话框过程，则无法使用使用此函数类型指定的回调函数。 这是因为_CPSUICALLBACK类型的回调是从 CPSUI 的对话框过程调用的，如果应用程序提供自己的过程，则不会使用这些过程。

要求

要求	值
目标平台	桌面
标头	compstui.h (包括 Compstui.h)