通过

PropSheet_SetWizButtons宏 （prsht.h）

  • 项目

通过发布 PSM_SETWIZBUTTONS 消息，启用或禁用向导中的“返回”、“下一步”和“完成”按钮。 可以使用此宏或显式发送 PSM_SETWIZBUTTONS 消息。

语法

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

参数

hDlg

类型：HWND

属性表的句柄。

dwFlags

类型：DWORD

一个值，该值指定启用哪个向导按钮。 可以组合以下一个或多个标志。

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

返回值

类型：VOID

无返回值。

言论

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

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

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 prsht.h