CPropertySheet::Create

Článek
03/04/2013

Zobrazí nemodální vlastností.

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

Parametry

pParentWnd
Odkazuje na nadřazené okno.Pokud NULL, je nadřazený plochy.
dwStyle
Styly okna vlastností.Úplný seznam dostupných stylů, viz Styly oken.
dwExStyle
Styly oken vlastností pro Extended.Úplný seznam dostupných stylů, viz Extended styly oken

Vrácená hodnota

Nenulová hodnota, pokud seznam vlastností je vytvořena úspěšně; jinak 0.

Poznámky

Volání vytvořit může být uvnitř konstruktoru nebo volání po vyvolání konstruktoru.

Výchozí styl, vyjádřený v předávání –1 jako dwStyle , je ve skutečnosti WS_SYSMENU|WS_POPUP|WS_CAPTION|DS_MODALFRAME|DS_CONTEXTHELP| WS_VISIBLE.Extended výchozí styl okna vyjádřené předáním 0 jako dwExStyle , je ve skutečnosti WS_EX_DLGMODALFRAME.

Vytvořit členské funkce vrací ihned po vytvoření seznamu vlastností.Zničit vlastností, volání CWnd::DestroyWindow.

Nemodální vlastností zobrazeny pomocí volání vytvořit jako modální okno vlastností nemají tlačítka OK, Storno, použít a nápovědy.Uživatel musí být vytvořeny požadovaná tlačítka.

Vlastnost Modální okno volání DoModal místo.

Příklad

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