CPropertySheet::Create

Artykuł
02/27/2013

Wyświetla arkusz właściwości niemodalny.

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

Parametry

pParentWnd
Punkty do okna nadrzędnego.Jeśli NULL, nadrzędny jest pulpit.
dwStyle
Style okna Arkusz właściwości.Aby uzyskać pełną listę dostępnych stylów, zobacz Style okna.
dwExStyle
Extended style okna Arkusz właściwości.Aby uzyskać pełną listę dostępnych stylów, zobacz Extended style okien

Wartość zwracana

Niezerowa, jeśli arkusz właściwości jest tworzony pomyślnie; 0 inaczej.

Uwagi

Wywołanie Tworzenie może być wewnątrz konstruktora lub można go wywołać, po wywołaniu konstruktora.

Domyślny styl wyrażone przez przekazanie –1 jako dwStyle, jest rzeczywiście WS_SYSMENU|WS_POPUP|WS_CAPTION|DS_MODALFRAME|DS_CONTEXTHELP| WS_VISIBLE.Domyślnie extended wyrażone przez przekazanie 0 jako styl okna dwExStyle, jest rzeczywiście WS_EX_DLGMODALFRAME.

Tworzenie Członkowskich funkcja zwraca natychmiast po utworzeniu arkusza właściwości.Zniszczenie arkusz właściwości, należy wywołać CWnd::DestroyWindow.

Arkusze właściwości niemodalny wyświetlane wywołania Tworzenie nie mają przycisków OK, Anuluj, stosuje się teraz i pomocy, jak arkusze właściwości modalny.Żądane przyciski musi być utworzone przez użytkownika.

Aby wyświetlić arkusz właściwości modalny, call DoModal zamiast.

Przykład

// 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;
}