CPropertySheet::Create

發行項
02/28/2013

顯示非強制回應的屬性工作表。

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

參數

pParentWnd
父視窗的點。如果 NULL，父代為桌面。
dwStyle
屬性工作表的視窗樣式。如需可用樣式的完整清單，請參閱視窗樣式。
dwExStyle
屬性工作表的延伸視窗樣式。如需可用樣式的完整清單，請參閱延伸視窗樣式。

傳回值

如果不是零，則屬性工作表成功建立，則為 0。

備註

建立對的呼叫可以是在建構函式中，也可以呼叫它，在建構函式之後叫用。

建立成員函式在建立屬性工作表立即傳回。若要終結屬性工作表，請呼叫 CWnd::DestroyWindow。

非強制回應對話方塊的屬性工作表顯示以呼叫建立不具決定性，並不會同時，不會出現在和按鈕，強制回應屬性工作表。必須是由使用者建立的按鈕。

若要顯示強制回應屬性工作表，請呼叫 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;
}