CPropertyPage::Construct

Статья
02/20/2013

Эта функция-член вызывается с целью создания объекта CPropertyPage.

void Construct(
   UINT nIDTemplate,
   UINT nIDCaption = 0 
);
void Construct(
   LPCTSTR lpszTemplateName,
   UINT nIDCaption = 0 
);
void Construct(
   UINT nIDTemplate,
   UINT nIDCaption,
   UINT nIDHeaderTitle,
   UINT nIDHeaderSubTitle = 0 
);
void Construct(
   LPCTSTR lpszTemplateName,
   UINT nIDCaption,
   UINT nIDHeaderTitle,
   UINT nIDHeaderSubTitle = 0 
);

Параметры

nIDTemplate
Идентификатор шаблона, используемого для этой страницы.
nIDCaption
Имя/идентификатор, который требуется поместить на вкладке для этой страницы.Если значение равно 0, имя будет берется из шаблона диалоговых окон для этой страницы.
lpszTemplateName
Содержит null- завершенную строку, имя ресурса шаблона.
nIDHeaderTitle
Имя/идентификатор, который необходимо поместить в месте названия заголовка страницы свойств.По умолчанию, 0.
nIDHeaderSubTitle
Имя/идентификатор, который необходимо поместить в месте субтитра заголовка страницы свойств.По умолчанию, 0.

Заметки

Объект отображается после того, как все выполняются следующие условия:

Страница была добавлена на страницу свойств с помощью CPropertySheet::AddPage.
Функция DoModal или Создание страницы свойств была называется.
Пользователь выбрал (эта страница с вкладками).

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

Необходимо использовать Construct при работе с массивами, и необходимо вызвать Construct для каждого члена массива, чтобы присвоить элементам данных правильные значения.

Пример

// Declare a CPropertySheet object.
CPropertySheet sheet(_T("Simple PropertySheet"));

// Create three CPropertyPage objects whose template IDs are specified
// in rgID array, and add each page to the CPropertySheet object. 
const int c_cPages = 3;
CPropertyPage   pages[c_cPages];
UINT rgID[c_cPages] = {IDD_STYLE, IDD_COLOR, IDD_SHAPE};
for (int i = 0; i < c_cPages; i++)    
{
   pages[i].Construct(rgID[i]);
   sheet.AddPage(&pages[i]);
}

// Display a modal CPropertySheet dialog.
sheet.DoModal();