CPropertySheet::Create

Статья
06/10/2015

Указывает страницу свойств modeless.

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

Параметры

pParentWnd
Элементы родительского окна. Если NULL родительский рабочий стол.
dwStyle
Стили окна страницы свойств. Полный список доступных стилей см. в разделе стили окна.
dwExStyle
Расширенные стили окна страницы свойств. Полный список доступных стилей см. в разделе Расширенные стили окна

Возвращаемое значение

Ненулевой если страница свойств создана успешно; в противном случае – значение 0.

Заметки

Вызов Создать может быть внутри конструктора, либо можно вызывать после того, как вызывается конструктор.

Стиль по умолчанию, выраженный путем передачи – 1 dwStyle, фактически WS_SYSMENU | WS_POPUP | WS_CAPTION | DS_MODALFRAME | DS_CONTEXTHELP | WS_VISIBLE. По умолчанию расширенный стиль окна, выраженный, передавая значение 0 как dwExStyle, фактически WS_EX_DLGMODALFRAME.

Функция-член Создать возвращается немедленно после создания страницы свойств. Удалить страницу свойств, вызов CWnd::DestroyWindow.

Безрежимное страницы свойств, отображаемых с вызовом Создать не имеют ОК, Отмену, а не для применения кнопки Справки теперь и как модальные страницы свойств. Требуемые кнопки должны быть созданы пользователем.

Отобразить режимную страницу свойств, вызов DoModal.

Пример

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