CPropertySheet::AddPage

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

更新 : 2007 年 11 月

指定したページをプロパティシートの右端のタブとして追加します。

void AddPage(
   CPropertyPage *pPage 
);

パラメータ

pPage
プロパティシートに追加するページへのポインタ。NULL は指定できません。

解説

ページを表示順 (左から右) にプロパティシートに追加します。

AddPage は、CPropertySheet オブジェクトのページのリストに CPropertyPage オブジェクトを追加しますが、実際にそのページ用のウィンドウは作成しません。ユーザーがそのページを選択するまで、フレームワークはページ用のウィンドウを作成しません。

AddPage でプロパティページを追加すると、CPropertySheet が CPropertyPage の親になります。プロパティページからプロパティシートにアクセスするには、CWnd::GetParent を呼び出します。

AddPage の呼び出しをプロパティシートウィンドウが作成されるまで待つ必要はありません。一般的には、DoModal または Create の呼び出し以前に、AddPage を呼び出します。

プロパティページが表示された後に AddPage を呼び出すと、タブの列には新たに追加されたページが反映されます。

使用例

// Add three pages to a CPropertySheet object, then show the 
// CPropertySheet object as a modal dialog.  CStylePage, CShapePage,  
// and CColorPage are CPropertyPage-derived classes created 
// by the Add Class wizard.  

CPropertySheet dlgPropertySheet(_T("Simple PropertySheet"));

CStylePage     stylePage;
CColorPage     colorPage;
CShapePage     shapePage;
dlgPropertySheet.AddPage(&stylePage);
dlgPropertySheet.AddPage(&colorPage);
dlgPropertySheet.AddPage(&shapePage);

dlgPropertySheet.DoModal();