CPropertyPage::Construct

Статья
06/10/2015

Эта функция-член вызывается с целью создания объекта 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();