CPropertyPage::OnWizardFinish

virtual BOOL OnWizardFinish( );

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

Ненулевое, если окно мастера было уничтожено при завершении его работы, и нулевое в противном случае.

Примечание

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

Если данная функция возвращает значение TRUE, то диалоговое окно с вкладками уничтожается и мастер прекращает свою работу. В противном случае диалоговое окно с вкладками не уничтожается.

CPropertyPage::OnWizardNext

virtual LRESULT OnWizardNext();

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

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

Примечание

Данная функция вызывается приложением при нажатии пользователя на кнопку Далее> в окне мастера. Перегрузка данной функции позволяет определить некоторые действия, которые необходимо предпринять при переходе к следующей странице.

CPropertySheet

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

Хотя класс CPropertySheet и не является производным от класса CDialog, многие функции данного класса, совпадают с функциями класса CDialog. Например, объект данного класса также создаётся в два этапа: сначала вызывается конструктор класса, а затем функция DoModal для создания модального диалогового окна с вкладками, или Create для создания немодального диалогового окна. Класс CPropertySheet имеет два типа конструкторов: CPropertySheet::Construct и CPropertySheet::CPropertySheet.

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

Класс CPropertySheet позволяет создать диалоговое окно, оформленное в стиле мастера, представляющее собой последовательность вкладок, перемещение по которым происходит в определённой последовательности и управляется специальными кнопками в диалоговом окне. В диалоговом окне мастера вкладки не имеют ярлыков и на экране отображается только одна вкладка. Вместо кнопок OK и Применить, в диалоговом окне мастера используются кнопки <Назад, Далее> или Готово. Кроме этого в нём используются кнопки Отмена и Справка.

Чтобы создать диалоговое окно мастера, необходимо сначала создать простое диалоговое окно с вкладками, а затем, перед вызовом функции DoModal, вызвать функцию SetWizardButtons. Для того чтобы после завершения работы пользователя с окном в нём появилась кнопка Готово, вызовите функцию SetFinishText.

Описание данного класса содержится в файле заголовка afxdlgs.h.