CPropertySheet::DoModal

Статья
06/10/2015

Указывает режимную страницу свойств.

virtual INT_PTR DoModal();

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

IDOK или IDCANCEL если функция была успешна; в противном случае – значение 0 или -1. Если страница свойств полномочиями, как мастер (см. SetWizardMode), то DoModal возвращает или ID_WIZFINISH или IDCANCEL.

Заметки

Возвращаемое значение соответствует идентификатору элемента управления, который закрыл страница свойств. После того как эта функция вернет, будут уничтожены окна, соответствующий странице свойств и всем страницам. Объекты сами по-прежнему будут существовать. Обычно получение данных из объектов CPropertyPage после DoModal возвращает IDOK.

Для отображения страницы свойств modeless, вызовите Создание.

Когда страница свойств создана из соответствующего ресурса диалогового окна, она может вызвать исключение перв- вероятность. Это получаемый в результате страницы свойств ресурсов при изменении стиля диалогового окна в требуемый стиль, прежде чем страница создана. Поскольку ресурсы обычно только для чтения, это вызывает исключение. Система обрабатывает исключение и создает копию измененного ресурса. Исключение перв- поэтому вероятность можно игнорировать.

Примечание

Данное исключение должно быть обработано операционной системой при компилировании с асинхронной модели обработки ошибок.Дополнительные сведения о моделях обработки ошибок см. в разделе Параметр /EH (модель обработки исключений).В этом случае не создавайте программу-оболочку вызовы CPropertySheet::DoModal с блоком CATCH попытк- C++, в котором захватывающие рукоятки все исключения, например, catch (...).Этот блок отрегулировал исключение требуемое для операционной системы, и непредсказуемого поведения причины.Однако можно безопасно использовать обработку исключений C++ с определенными типами исключения, либо структурную обработку исключений, где исключение Нарушения прав доступа передается в операционной системе.

Чтобы избежать формирования это исключение перв- вероятность можно вручную гарантировать, что страница свойств имеет правильное Стили окна. Необходимо задать следующие стили для страницы свойств:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Можно использовать следующие необязательные стили, не вызывая исключения перв- вероятность:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Отключите все остальные стили Windows, потому что они несовместимы с помощью страниц свойств. Эта консультация не применяется к расширенным стилей. Устанавливать эти стандартные стили соответствующим образом гарантирует, что страница свойств не должна быть изменена и следует избегать создания исключения перв- вероятность.