PropSheet_CancelToClose宏 (prsht.h)

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

语法

void PropSheet_CancelToClose(
   hDlg
);

参数

hDlg

类型： HWND

属性表的句柄。

返回值

无

备注

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

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

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

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

注意使用 Aero 向导样式 (PSH_AEROWIZARD) 时，不支持此宏。

 

要求

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