CPropertySheet::Create

Article
06/10/2015

Affiche une feuille de propriétés non modale.

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

Paramètres

pParentWnd
Points à la fenêtre parente. Si NULL, parent est le Bureau.
dwStyle
Styles de fenêtre pour la feuille de propriétés. Pour une liste complète des styles disponibles, consultez styles de fenêtre.
dwExStyle
Styles de fenêtre étendus pour la feuille de propriétés. Pour une liste complète des styles disponibles, consultez styles de fenêtre étendus

Valeur de retour

Une valeur différente de zéro si la feuille de propriétés est créée avec succès ; sinon 0.

Notes

L'appel à Créer peut être dans le constructeur, ou vous pouvez l'appeler après que le constructeur est appelé.

Le style par défaut, exprimé en passant à 1 comme dwStyle, est réellement WS_SYSMENU | WS_POPUP | WS_CAPTION | DS_MODALFRAME | DS_CONTEXTHELP | WS_VISIBLE. Le style de fenêtre étendu par défaut, exprimé en passant 0 comme dwExStyle, est réellement WS_EX_DLGMODALFRAME.

La fonction membre de Créer retourne immédiatement après créer la feuille de propriétés. Pour détruire la feuille de propriétés, appelez CWnd::DestroyWindow.

Les feuilles de propriétés non modaux affichent avec un appel à Créer n'ont pas OK, ne s'annulent pas, ne s'appliquent pas des boutons à présent, et d'aide comme le font les feuilles de propriétés modaux. Les boutons souhaités doivent être créés par l'utilisateur.

Pour afficher une feuille de propriétés modale, appelez DoModal à la place.

Exemple

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