CPropertySheet::AddPage
プロパティ シートの右端のタブを持つ指定されたページを追加します。
void AddPage(
CPropertyPage *pPage
);
パラメーター
- pPage
プロパティ シートに追加するページへのポインター。nullにすることはできません。
解説
左から右の順序でプロパティ シートに追加するページ上に表示するです。
AddPage は CPropertySheet のページのオブジェクト リストへの CPropertyPage のオブジェクトを追加しますが、実際にページのウィンドウを作成しません。フレームワークは、ページに対してユーザーがそのページを選択するまで、ウィンドウの作成を延期します。
AddPageを使用したプロパティ ページを追加すると、CPropertySheet は CPropertyPageの親です。プロパティ ページのプロパティ シートにアクセスするためには、CWnd::GetParentを呼び出します。
プロパティ シートのウィンドウが作成されるまで待機する必要が AddPageを呼び出す必要はありません。通常、DoModal か [作成]を呼び出す前 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();
必要条件
ヘッダー : afxdlgs.h