CPropertySheet::Create
This method displays a modeless property sheet. You can call Create from inside the constructor, or you can call it after the constructor is invoked.
BOOL Create(
CWnd* pParentWnd = NULL,
DWORD dwStyle = (DWORD)–1,
DWORD dwExStyle = 0 );
Parameters
- pParentWnd
Points to parent window. If NULL, parent is the desktop. - dwStyle
Specifies the Window styles for property sheet. For a complete list of available styles, see Window Styles. - dwExStyle
Specifies the Extended window styles for property sheet. For a complete list of available styles, see Extended Window Styles.
Return Value
Nonzero if the property sheet is created successfully; otherwise, it is zero.
Remarks
The default style, expressed by passing –1 as dwStyle, is actually WS_SYSMENU | WS_POPUP | WS_CAPTION | DS_MODALFRAME | DS_CONTEXT_HELP | WS_VISIBLE. The default extended window style, expressed by passing 0 as dwExStyle, is actually WS_EX_DLGMODALFRAME.
The Create method returns immediately after creating the property sheet. To destroy the property sheet, call CWnd::DestroyWindow.
Modeless property sheets displayed with a call to Create do not have OK, Cancel, Apply Now, and Help buttons as modal property sheets do. Desired buttons must be created by the user.
To display a modal property sheet, call CPropertySheet::DoModal instead.
Example
// This code fragment shows how to create a modeless property sheet // dialog in a command message handler (OnModelessPropertySheet()) // of a CView-derived class. void CMyView::OnModelessPropertySheet() { // Declare a CPropertySheet object. m_dlgPropertySheet is a data // member of type CPropertySheet in CView-derived class. m_dlgPropertySheet = new CPropertySheet("Simple PropertySheet"); ASSERT(m_dlgPropertySheet); // Add two pages to the CPropertySheet object. Both m_stylePage and // m_colorPage are data members of type CPropertyPage-derived classes // in CView-derived class. m_stylePage = new CStylePage; m_colorPage = new CColorPage; m_dlgPropertySheet->AddPage(m_stylePage); m_dlgPropertySheet->AddPage(m_colorPage); // Create a modeless CPropertySheet dialog. m_dlgPropertySheet->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. CMyView::~CMyView() { if (m_dlgPropertySheet) { delete m_stylePage; delete m_colorPage; delete m_dlgPropertySheet; } }
Requirements
** Windows CE versions:** 1.0 and later
Header file: Declared in Afxdlgs.h
Platform: H/PC Pro, Palm-size PC, Pocket PC