CPropertySheet::Create

Artikel
02/26/2013

Zeigt ein nicht modales Eigenschaftenblatt an.

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

Parameter

pParentWnd
verweist auf dem übergeordneten Fenster.Wenn NULL, übergeordnetes Element der Desktop ist.
dwStyle
Fensterstile für Eigenschaftenblatt.Eine vollständige Liste der verfügbaren Formaten, finden Sie unter Fensterstile.
dwExStyle
Erweiterte Fensterstile für Eigenschaftenblatt.Eine vollständige Liste der verfügbaren Formaten, finden Sie unter Erweiterte Fensterstile

Rückgabewert

Ungleich 0 (null), wenn das Eigenschaftenblatt erfolgreich erstellt wird; 0 andernfalls.

Hinweise

Der Aufruf Create kann innerhalb des Konstruktors sein, oder Sie können ihn aufrufen, nachdem der Konstruktor aufgerufen wird.

Der Standardstil, ausgedrückt durch Übergeben - 1 als dwStyle, ist eigentlich WS_SYSMENU|WS_POPUP|WS_CAPTION|DS_MODALFRAME|DS_CONTEXTHELP| WS_VISIBLE.Der standardmäßige erweiterte Fensterstil, ausgedrückt, indem er 0 als dwExStyle übergibt, ist eigentlich WS_EX_DLGMODALFRAME.

Die Create-Memberfunktion wird sofort nach dem Erstellen des Eigenschaftenblatts zurück.Um das Eigenschaftenblatt zu zerstören, rufen Sie CWnd::DestroyWindow auf.

Die nicht modalen Eigenschaftenblätter, die mit einem Aufruf von Create angezeigt werden, haben keine OK, brechen ab, gelten jetzt und Hilfe-Tasten zu, wie modale Eigenschaftenblätter ausführen.Die gewünschte Schaltflächen müssen vom Benutzer erstellt werden.

Um ein modales Eigenschaftenblatt anzuzeigen, rufen Sie DoModal stattdessen auf.

Beispiel

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