CPropertySheet::AddPage

void AddPage( CPropertyPage *pPage );

Аргументы

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

Примечание

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

Функция AddPage добавляет вкладку в окно, но не отображает её на экране. Отображение происходит только после выбора соответствующего ярлыка вкладки.

Диалоговое окно является родительским окном для вкладки, поэтому, для доступа к нему из объекта вкладки может быть использована функция CWnd::GetParent.

Вызов функции AddPage может быть осуществлён до вызова функций DoModal или Create. При вызове данной функции в открытом диалоговом окне в ряду ярлыков немедленно произойдут соответствующие изменения.

CPropertySheet::Construct

void Construct( UINT nIDCaption, CWnd* pParentWnd = NULL, UINT iSelectPage = 0 );

void Construct( LPCTSTR pszCaption, CWnd* pParentWnd = NULL, UINT iSelectPage = 0 );

Аргументы

0. nIDCaption — идентификатор заголовка диалогового окна с вкладками.

1. pParentWnd — указатель на родительское окно диалогового окна с вкладками. Если данный аргумент равен нулю, то родительским окном для данного окна будет главное окно приложения.

2. iSelectPage — индекс вкладки, которая должна быть открытой при открытии окна. По умолчанию раскрывается первая вкладка. Нумерация вкладок определяется порядком включения их в диалоговое окно.

3. pszCaption — указатель на строку, содержащую заголовок диалогового окна с вкладками. Данный аргумент не может иметь нулевое значение.

Примечание

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

Для вывода диалогового окна с вкладками на экран используются функции DoModal и Create. Строка, определяемая первым аргументом данной функции, помещается в заголовок диалогового окна.

Пример

int i;

CPropertySheet grpropsheet[4];

CPropertySheet someSheet; // Для данного объекта нет необходимости вызывать

// функцию Construct

UINT rgID[4] = {IDD_SHEET1, IDD_SHEET2, IDD_SHEET3, IDD_SHEET4};

for (i = 0; i < 4; i++)

grpropsheet[i].Construct(rgID[i]);

CPropertySheet::cPropertySheet

CPropertySheet( );

CPropertySheet( UINT nIDCaption, CWnd *pParentWnd = NULL, UINT iSelectPage = 0 );

CPropertySheet( LPCTSTR pszCaption, CWnd *pParentWnd = NULL, UINT iSelectPage = 0 );

Аргументы

0. nIDCaption — идентификатор заголовка диалогового окна с вкладками.

1. pParentWnd — указатель на родительское окно диалогового окна с вкладками. Если данный аргумент равен нулю, то родительским окном для данного окна будет главное окно приложения.

2. iSelectPage — индекс вкладки, которая должна быть открытой при открытии окна. По умолчанию раскрывается первая вкладка. Нумерация вкладок определяется порядком включения их в диалоговое окно.

3. pszCaption — указатель на строку, содержащую заголовок диалогового окна с вкладками. Данный аргумент не может быть нулевым.

Примечание

Данная функция используется для создания объектов класса CPropertySheet. Для вывода диалогового окна с вкладками на экран используются функции DoModal и Create. Строка, определяемая первым аргументом данной функции, помещается в заголовок диалогового окна.