макрос PropSheet_CancelToClose (prsht.h)

Статья
10/24/2024

Используется, когда изменения, внесенные с момента последнего уведомления PSN_APPLY, не могут быть отменены. Вы также можете явно отправить сообщение PSM_CANCELTOCLOSE.

Синтаксис

VOID PropSheet_CancelToClose(
   HWND hDlg
);

Параметры

hDlg

Тип: HWND

Дескриптор на лист свойств.

Возвращаемое значение

Тип: VOID

Возвращаемое значение не возвращается.

Замечания

PSM_CANCELTOCLOSE отключает кнопку "Отмена " и изменяет текст кнопки "Закрыть". Этот макрос можно использовать или явно отправить сообщение PSM_CANCELTOCLOSE.

Большинство листов свойств ожидает необратимых изменений до получения уведомления PSN_APPLY. Однако в некоторых случаях лист свойств может вносить необратимые изменения за пределами стандартной последовательности PSN_APPLY/PSN_RESET. Одним из примеров является лист свойств, содержащий кнопку "Изменить", которая используется для отображения поля поддиалога для редактирования свойства. Когда пользователь нажимает кнопку ОК для отправки изменения, страница листа свойств имеет несколько вариантов:

Он может записывать изменения, но ждать, пока он не получит уведомление PSN_APPLY, чтобы применить их. Это предпочтительный подход.
Он может применять изменения сразу после выхода из поля поддиалога, но помните исходные параметры. Эти параметры можно использовать для восстановления исходного состояния, если получено уведомление PSN_RESET.
Он может немедленно применить изменения и не попытаться восстановить исходные параметры при получении уведомления PSN_RESET. Этот подход не рекомендуется, но может потребоваться, если изменения слишком далеко достигают других двух вариантов, чтобы быть практическими.

Для третьего варианта приложения должны отправлять PSM_CANCELTOCLOSE сообщение на лист свойств. Он указывает пользователю, что изменения, внесенные в поле поддиалога, не могут быть отменены, нажав кнопку Отмена.

Примечание Этот макрос не поддерживается при использовании стиля мастера Аэро (PSH_AEROWIZARD).

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	prsht.h

Поделиться через