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

Статья
10/24/2024

Используется листами свойств без режима для получения сведений, возвращаемых модальным листам свойств, PropertySheet. Этот макрос можно использовать или явно отправить сообщение PSM_GETRESULT.

Синтаксис

int PropSheet_GetResult(
   HWND hDlg
);

Параметры

hDlg

Тип: HWND

Обработайте диалоговое окно листа свойств.

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

Тип: int

Возвращает положительное значение в случае успешного выполнения или -1 в противном случае. Следующие возвращаемые значения имеют особое значение.

Возвращаемый код	Описание
ID_PSREBOOTSYSTEM	Страница отправила PSM_REBOOTSYSTEM сообщение на лист свойств. Чтобы изменения пользователя вступили в силу, необходимо перезапустить компьютер.
ID_PSRESTARTWINDOWS	Страница отправила PSM_RESTARTWINDOWS сообщение на лист свойств. Для того чтобы изменения пользователя вступили в силу, необходимо перезапустить Windows.

Замечания

Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Возвращаемое значение идентично тому, что PropertySheet возвращалось, если бы это был модальный лист свойств.

Версия 5.80. Возвращаемое значение PropertySheet содержит различные сведения для модальных и немодальных листов свойств. В некоторых случаях безрежимные таблицы свойств могут потребовать сведения, полученные от PropertySheet, если они были модальными. В частности, им может потребоваться знать, были ли возвращены ID_PSREBOOTSYSTEM или ID_PSRESTARTWINDOWS.

Для листа свойств без режима цикл сообщений должен использовать PSM_ISDIALOGMESSAGE для передачи сообщений в диалоговое окно листа свойств и PSM_GETCURRENTPAGEHWND, чтобы определить, когда нужно уничтожить диалоговое окно. Когда пользователь нажимает кнопку ОК или "Отмена", PSM_GETCURRENTPAGEHWND возвращает NULL. Затем можно получить значение, полученное модальным листом свойств из PropertySheet, отправив сообщение PSM_GETRESULT.

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

Требования

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

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