通过

PSM_SETWIZBUTTONS消息

  • 项目

启用或禁用向导中的“返回”、“下一步”和“完成”按钮。 还可以使用 PropSheet_SetWizButtons 宏发布消息。

参数

wParam

将此参数设置为 PSWIZBF_ELEVATIONREQUIRED，以在 lParam 中指定的按钮上显示提升的图标。 提升的图标 (或 UAC 防护图标) 指示将使用提升提示来提示用户批准或凭据。 有关详细信息，请参阅 设计适用于 Windows Vista 的 UAC 应用程序。

注意

仅在 AeroWizards (PSH_AEROWIZARD) 中支持显示 UAC 防护图标。

lParam

指定启用哪些属性表按钮的值。 可以组合以下一个或多个标志。

值 含义
PSWIZB_BACK
 启用“ 后退 ”按钮。 如果未设置此标志，则 “后退 ”按钮显示为“已禁用”。
PSWIZB_DISABLEDFINISH
 显示禁用的 “完成” 按钮。
PSWIZB_FINISH
 显示已启用的 “完成” 按钮。
PSWIZB_NEXT
 启用“下一步”按钮。 如果未设置此标志，“ 下一步 ”按钮将显示为“已禁用”。

返回值

没有返回值。

备注

如果通知处理程序使用 PostMessage 发送 PSM_SETWIZBUTTONS 消息，则在处理程序返回之前不执行任何影响窗口焦点的操作。 例如，如果在使用 PostMessage 发送PSM_SETWIZBUTTONS后立即调用 MessageBox，消息框将接收焦点。 由于已发布的消息在到达消息队列的头之前不会传递，因此在向导失去对消息框的焦点之前，不会传递 PSM_SETWIZBUTTONS 消息。 因此，属性表将无法正确设置按钮的焦点。

如果在处理PSN_SETACTIVE通知期间发送 PSM_SETWIZBUTTONS 消息，请使用 PostMessage 函数而不是 SendMessage 函数。 否则，系统将无法正确更新按钮。 如果使用 PropSheet_SetWizButtons 宏发送此消息，则会发布该消息。 在任何其他时间，可以使用 SendMessage 发送 PSM_SETWIZBUTTONS。

向导在每个页面下方显示三个或四个按钮。 此消息用于指定启用哪些按钮。 向导通常显示“返回”、“取消”和“下一步”或“完成”按钮。 通常只为欢迎页启用“ 下一步 ”按钮，为内部页面启用 “下一步 ”和“ 上一步” 按钮，为完成页启用“ 返回 ”和“ 完成 ”。 始终启用 “取消 ”按钮。 通常，设置PSWIZB_FINISH或PSWIZB_DISABLEDFINISH会将 “下一步 ”按钮替换为“ 完成 ”按钮。 若要同时显示“下一步”和“完成”按钮，请在创建向导的 PROPSHEETHEADER 结构的 dwFlags 成员中设置PSH_WIZARDHASFINISH标志。 然后，每个页面将显示所有四个按钮。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
标头
Prsht.h