CPropertySheet::Create

[アーティクル]
08/09/2011

モードレスプロパティシートを表示します。

virtual BOOL Create(
   CWnd* pParentWnd = NULL,
   DWORD dwStyle = (DWORD)–1,
   DWORD dwExStyle = 0 
);

パラメーター

pParentWnd
親ウィンドウへのポインター。 NULL を指定すると、親ウィンドウはデスクトップウィンドウになります。
dwStyle
プロパティシートのウィンドウスタイル。指定できるスタイルの一覧は、「ウィンドウスタイル」を参照してください。
dwExStyle
プロパティシートの拡張ウィンドウスタイル。指定できるスタイルの一覧は、「拡張ウィンドウスタイル」を参照してください。

戻り値

プロパティシートが作成できた場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

Create 関数は、コンストラクターの内部から、またはコンストラクターを呼び出した後に呼び出せます。

Create メンバー関数は、プロパティシートを作成後、すぐに呼び出しから復帰します。プロパティシートを破棄するには、CWnd::DestroyWindow を呼び出します。

モードレスプロパティシートは、Create を呼び出すと表示されますが、モーダルプロパティシートで表示されるような、[OK]、[キャンセル]、[現在のものを使用]、[ヘルプ] の各ボタンを持っていません。ボタンが必要なときは、ユーザーが作成する必要があります。

モーダルプロパティシートを表示するには、DoModal を呼び出します。

使用例

// This code fragment shows how to create a modeless property sheet 
// dialog in a command message handler (OnModelessPropertySheet()) 
// of a CView-derived class.
void CPSheetView::OnModelessPropertySheet()
{
   // Declare a CPropertySheet object.  m_pdlgPropertySheet is a data
   // member of type CPropertySheet in CView-derived class.
   m_pdlgPropertySheet = new CPropertySheet(_T("Simple PropertySheet"));
   ASSERT(m_pdlgPropertySheet);

   // Add three pages to the CPropertySheet object.  Both m_pstylePage, 
   // m_pcolorPage, and m_pshapePage are data members of type 
   // CPropertyPage-derived classes in CView-derived class.
   m_pstylePage = new CStylePage;
   m_pcolorPage = new CColorPage;
   m_pshapePage = new CShapePage;
   m_pdlgPropertySheet->AddPage(m_pstylePage);
   m_pdlgPropertySheet->AddPage(m_pcolorPage);
   m_pdlgPropertySheet->AddPage(m_pshapePage);

   // Create a modeless CPropertySheet dialog.
   m_pdlgPropertySheet->Create(); 
}

// The code fragment below shows how to destroy the C++ objects for
// propertysheet and propertypage in the destructor of CView-derived
// class.
// NOTE:  DestroyWindow() is called in CPropertySheet::OnClose() so
// you do not need to call it here.  Property pages are children
// of the CPropertySheet, they will be destroyed by their parents.
CPSheetView::~CPSheetView()
{
   delete m_pshapePage;
   delete m_pstylePage;
   delete m_pcolorPage;
   delete m_pdlgPropertySheet;
}