CPropertySheet::Construct

Статья
02/20/2013

Создает объект CPropertySheet.

void Construct(
   UINT nIDCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
void Construct(
   LPCTSTR pszCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
void Construct(
   UINT nIDCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);
void Construct(
   LPCTSTR pszCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);

Параметры

nIDCaption
Идентификатор заголовка, используемый для страницы свойств.
pParentWnd
Указатель на родительское окно страницы свойств.Если NULL, родительское окно становится главным окном приложения.
iSelectPage
Индекс страницы, которая первоначально будет находиться сверху.По умолчанию используется первая страница, добавленной на лист.
pszCaption
Указатель на строку, содержащую заголовок, используемый для страницы свойств.Не может быть NULL.
hbmWatermark
Дескриптор растровое изображение предела страницы свойств.
hpalWatermark
Дескриптор палитру растрового изображения предела или растрового изображения заголовка.
hbmHeader
Дескриптор растровое изображение заголовка страницы свойств.

Заметки

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

Отображение страницы " свойства DoModal вызова или Создание.Строка, содержащихся в первом параметре будет размещена в верхнем колонтитуле страницы свойств.

Можно отобразить образы предела и/или заголовка автоматически при использовании третье и четвертое заполнители Construct приведенный выше, и передать допустимые значения для hbmWatermark, hpalWatermark или параметров hbmHeader.

Пример

Следующий пример демонстрирует, при каких обстоятельствах можно вызвать бы Construct.

const int c_cSheets = 3;
CPropertySheet   grpropsheet[c_cSheets];
// no need to call Construct for this next one
CPropertySheet   someSheet(_T("Some sheet"));

LPTSTR rgszSheets[c_cSheets] = {
   _T("Sheet 1"),
   _T("Sheet 2"),
   _T("Sheet 3")
};

for (int i = 0; i < c_cSheets; i++)
    grpropsheet[i].Construct(rgszSheets[i]);