CPropertySheet::DoModal

virtual int DoModal( );

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

IDOK или IDCANCEL, если работа с диалоговым окном завершилась без ошибок. В противном случае — 0 или –1. Если диалоговое окно было вызвано в режиме мастера, данная функция возвращает ID_WIZFINISH или IDCANCEL.

Примечание

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

Для отображения на экране немодального окна используется функция Create.

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

Поскольку данное исключение должно обрабатываться операционной системой, не помещайте вызов функции CPropertySheet::DoModal в блок try/catch, обрабатывающий все исключения, например, с использованием оператора catch (...). Данный оператор возьмёт на себя обработку исключения, предназначенного для операционной системы, что может привести к непредсказуемым последствиям.

CPropertySheet::GetPageIndex

int GetPageIndex( CPropertyPage* pPage ) const;

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

Индекс страницы.

Аргументы

0. pPage — указатель на вкладку, индекс которой следует получить. Не может принимать нулевое значение.

Примечание

Используется для получения числового индекса указанной вкладки в диалоговом окне с вкладками. Данная функция, как правило, используется совместно с функциями SetActivePage и GetPage.

CPropertySheet::SetActivePage

BOOL SetActivePage( int nPage );

BOOL SetActivePage( CPropertyPage* pPage );

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

Ненулевое, если активизация вкладки прошла успешно, и нулевое в противном случае.

Аргументы

0. nPage — индекс активизируемой вкладки. Значение данного аргумента может принимать любые значения в диапазоне от нуля до величины, на единицу меньшей числа вкладок в диалоговом окне.

1. pPage — указатель на объект класса активизируемой вкладки. Этот аргумент не может принимать нулевое значение.

Примечание

Функция SetActivePage используется для перехода между вкладками диалогового окна. Например, она может быть использована в том случае, если действие пользователя в одной вкладке требует открытия другой вкладки.

CPropertySheet::SetFinishText

void SetFinishText( LPCTSTR lpszText );

Аргументы

0. lpszText — указатель на строку, отображаемую в кнопке Готово.

Примечание

Данная функция вызывается для задания текста, отображаемого в кнопке Готово после завершения работы пользователя с окном мастера. Кроме отображения заданного теста данная функция убирает из диалогового окна кнопку <Назад.