通过

PropSheet_CancelToClose宏 （prsht.h）

  • 项目

在无法取消最近 PSN_APPLY 通知以来所做的更改时使用。 还可以显式发送 PSM_CANCELTOCLOSE 消息。

语法

VOID PropSheet_CancelToClose(
   HWND hDlg
);

参数

hDlg

类型：HWND

属性表的句柄。

返回值

类型：VOID

无返回值。

言论

PSM_CANCELTOCLOSE 禁用 “取消”按钮，并将“确定” 按钮 的文本更改为“关闭”。 可以使用此宏或显式发送 PSM_CANCELTOCLOSE 消息。

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

  • 它可以记录更改，但等到收到 PSN_APPLY 通知来应用更改。 这是首选方法。
  • 它可以在退出子日志框后立即应用更改，但请记住原始设置。 如果收到 PSN_RESET 通知，这些设置可用于还原原始状态。
  • 它可以立即应用更改，而不是在收到 PSN_RESET 通知时尝试还原原始设置。 不建议使用此方法，但如果更改太远，其他两个选项将不可行，则可能需要此方法。
对于第三个选项，应用程序应向属性表发送 PSM_CANCELTOCLOSE 消息。 它向用户指示，通过单击 “取消”按钮，无法撤消对子dialog 框所做的更改。
注意 使用航空向导样式（PSH_AEROWIZARD）时不支持此宏。
 

要求

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