CPropertySheet::Create

Статья
02/20/2013

Указывает страницу свойств 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;
}