CPropertySheet::Create

Articolo
02/19/2013

Visualizza una finestra delle proprietà non modale.

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

Parametri

pParentWnd
Punta alla finestra padre.Se NULL, padre è il desktop.
dwStyle
Stili della finestra per la finestra delle proprietà.Per un elenco completo degli stili disponibili, vedere Stili della finestra.
dwExStyle
Stili estesi della finestra per la finestra delle proprietà.Per un elenco completo degli stili disponibili, vedere Stili estesi della finestra

Valore restituito

Diverso da zero se la finestra delle proprietà viene creata correttamente; in caso contrario 0.

Note

La chiamata a Crea può essere nel costruttore, o è possibile chiamarlo dopo che viene richiamato il costruttore.

Lo stile predefinito, espresso passando a 1 come dwStyle, viene effettivamente WS_SYSMENU|WS_POPUP|WS_CAPTION|DS_MODALFRAME|DS_CONTEXTHELP| WS_VISIBLE.Lo stile esteso di finestre predefinito, espresso passaggio 0 come dwExStyle, viene effettivamente WS_EX_DLGMODALFRAME.

Funzione restituisce membro Crea immediatamente dopo la creazione della finestra delle proprietà.Per eliminare la finestra delle proprietà, chiamare CWnd::DestroyWindow.

Le finestre delle proprietà non modali visualizzato con una chiamata a Crea non hanno OK, l'annullamento, non si applicano ora e pulsante? come le finestre delle proprietà sono modali.I pulsanti desiderati devono essere creati dall'utente.

Per visualizzare una finestra delle proprietà modale, chiamare DoModal anziché.

Esempio

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