CPropertyPage::CPropertyPage

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CPropertyPage オブジェクトを構築します。

CPropertyPage( ); 
explicit CPropertyPage(
   UINT nIDTemplate,
   UINT nIDCaption = 0,
   DWORD dwSize = sizeof(PROPSHEETPAGE)
);
explicit CPropertyPage(
   LPCTSTR lpszTemplateName,
   UINT nIDCaption = 0,
   DWORD dwSize = sizeof(PROPSHEETPAGE)
);
CPropertyPage(
   UINT nIDTemplate,
   UINT nIDCaption,
   UINT nIDHeaderTitle,
   UINT nIDHeaderSubTitle = 0,
   DWORD dwSize = sizeof(PROPSHEETPAGE)
);
CPropertyPage(
   LPCTSTR lpszTemplateName,
   UINT nIDCaption,
   UINT nIDHeaderTitle,
   UINT nIDHeaderSubTitle = 0,
   DWORD dwSize = sizeof(PROPSHEETPAGE)
);

パラメータ

nIDTemplate
このページに使用するテンプレートの ID。
nIDCaption
このページのタブで使用する名前の ID。0 の場合、このページのダイアログテンプレートから名前を取得します。
dwSize
lpszTemplateName
このページのテンプレートの名前を持つ文字列へのポインタ。NULL は指定できません。
nIDHeaderTitle
プロパティページヘッダーのタイトル位置に表示する名前の ID。
nIDHeaderSubTitle
プロパティページヘッダーのサブタイトル位置に表示する名前の ID。

解説

オブジェクトは、次の条件がすべて満たされた場合に表示されます。

ページが CPropertySheet::AddPage を使って、プロパティシートに加えられた。
プロパティシートの DoModal または Create 関数が呼び出された。
ユーザーがこのページ (タブ) を選択した。

複数のパラメータがあるとき (配列を使っているときなど) は、CPropertyPage の代わりに CPropertySheet::Construct を使います。

使用例

// Declare a CStylePage object, which is a CPropertyPage-derived class.
CStylePage stylePage;

// Declare a CPropertyPage object with IDD_SHAPE, the ID of the 
// template used for this page. 
CPropertyPage shapePage(IDD_SHAPE);