Класс CPropertySheet

Статья
06/10/2015

Представляет страницы свойств, также известные как диалоговые окна " вкладки.

class CPropertySheet : public CWnd

Члены

Открытые конструкторы

Имя	Описание
CPropertySheet::CPropertySheet	Создает объект CPropertySheet.

Открытые методы

Имя	Описание
CPropertySheet::AddPage	Добавляет страницу со страницей свойств.
CPropertySheet::Construct	Создает объект CPropertySheet.
CPropertySheet::Create	Указывает страницу свойств modeless.
CPropertySheet::DoModal	Указывает режимную страницу свойств.
CPropertySheet::EnableStackedTabs	Указывает, использует ли страница свойств вкладки с накоплением или прокрутки.
CPropertySheet::EndDialog	Завершает страница свойств.
CPropertySheet::GetActiveIndex	Извлекает индекс текущей страницы свойств.
CPropertySheet::GetActivePage	Возвращает объект текущей страницы.
CPropertySheet::GetPage	Извлекает указатель на конкретной странице.
CPropertySheet::GetPageCount	Возвращает количество страниц в странице свойств.
CPropertySheet::GetPageIndex	Возвращает индекс заданной страницы свойств.
CPropertySheet::GetTabControl	Извлекает указатель на набор вкладок.
CPropertySheet::MapDialogRect	Преобразование единицы диалогового окна прямоугольника, чтобы экранировать единиц.
CPropertySheet::OnInitDialog	Переопределение, чтобы увеличить инициализации страницы свойств.
CPropertySheet::PressButton	Имитирует выбор указанной кнопки на странице свойств.
CPropertySheet::RemovePage	Удаляет страницу из страницы свойств.
CPropertySheet::SetActivePage	Программно задает объект текущей страницы.
CPropertySheet::SetFinishText	Задает текст для кнопки готово.
CPropertySheet::SetTitle	Задает заголовок страницы свойств.
CPropertySheet::SetWizardButtons	Включает кнопки мастера.
CPropertySheet::SetWizardMode	Включает режим работы мастера.

Открытые члены данных

Имя	Описание
CPropertySheet::m_psh	Структура Windows PROPSHEETHEADER. Предоставляет доступ к основным параметры страницы свойств.

Заметки

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

CPropertySheet обеспечивает поддержку структуры развернутой PROPSHEETHEADER появившейся в Windows 98 и Windows NT 2000. Структура содержит дополнительные флаги и члены, которые поддерживают использование растровое изображение фона "предела".

Для отображения этих новых образов автоматического в объекте страницы свойств, передайте допустимые значения для образов растрового изображения и цветов в вызове CPropertySheet::Construct или CPropertySheet::CPropertySheet.

Даже если CPropertySheet не является производным от CDialog, управлять объект CPropertySheet управлении объект CDialog. Например, создание страницы свойств требует двухраздельной конструкции: вызовите конструктор, и затем вызовите DoModal для режимной страницы свойств или немодального Создание страницы свойств. CPropertySheet существует 2 типа конструкторов: CPropertySheet::Construct и CPropertySheet::CPropertySheet.

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

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

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

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Любое другое Window Styles запрещено, а не следует включать их.

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

Можно создать тип диалогового окна " вкладки мастером, который состоит из страниц свойств с последовательностью страниц свойств, которые направляют пользователя через этапы операции, как настраивать устройство или создать газетную верстку. В диалоговом окне страницы свойств вкладки мастер- типа, не имеющих вкладки и только одна страница свойств видима одновременно. Кроме того, вместо иметь ОК и кнопки Применить " диалогового окна " вкладки мастер- типа имеется кнопка Назад, кнопку Далее или Готово, кнопку Отмена и кнопку Справка.

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

Дополнительные сведения о том, как использовать объекты CPropertySheet см. в статье страницы свойств и страницы свойств. Кроме того, Q146916 см. в статье базы знаний Майкрософт: Практическое руководство: Создайте modeless CPropertySheet со стандартными кнопками и статьей Q300606: Практическое руководство: Создание изменяемого размера страницы свойств MFC.