PSM_CANCELTOCLOSE消息

应用程序在 自最近PSN_APPLY 无法取消的通知以来执行更改时发送。 可以显式发送此消息,也可以使用 PropSheet_CancelToClose 宏发送。

参数

wParam

必须为零。

lParam

必须为零。

返回值

没有返回值。

备注

PSM_CANCELTOCLOSE 禁用“ 取消 ”按钮并将 “确定” 按钮的文本更改为“关闭”。

大多数属性表会等待执行不可逆的更改,直到收到PSN_APPLY通知。 但是,在某些情况下,属性表可能会在标准PSN_APPLY/PSN_RESET序列之外进行不可逆转的更改。 一个示例是属性表,其中包含用于显示用于编辑属性的子对话框的“ 编辑 ”按钮。 当用户单击“ 确定” 提交更改时,属性表页有多个选项。

  • 它可以记录更改,但要等到收到PSN_APPLY通知后再应用更改。 这是首选方法。
  • 它可以在退出子对话框后立即应用更改,但请记住原始设置。 如果收到PSN_RESET通知,这些设置可用于还原原始状态。
  • 它可以立即应用更改,并且不会在收到 PSN_RESET 通知时尝试还原原始设置。 不建议使用此方法,但如果更改范围太深,其他两个选项不可行,则此方法可能是必需的。

对于第三个选项,应用程序应将 PSM_CANCELTOCLOSE 消息发送到属性表。 它向用户指示,无法通过单击“ 取消 ”按钮来撤消对子对话框所做的更改。

注意

使用 Aero 向导样式 (PSH_AEROWIZARD ) 时,不支持此消息。

要求

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