CPropertySheet::Create

Artigo
02/25/2013

Exibe uma folha de propriedades sem janela restrita.

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

Parâmetros

pParentWnd
Pontos a janela pai.Se NULO, pai é a área de trabalho.
dwStyle
Estilos de janela para a folha de propriedades.Para obter uma lista completa de estilos disponíveis, consulte Estilos de janela.
dwExStyle
Estilos estendidos da janela para a folha de propriedades.Para obter uma lista completa de estilos disponíveis, consulte Estilos estendidos da janela

Valor de retorno

Diferente de zero se a folha de propriedades é criado com êxito; se não 0.

Comentários

A chamada a Criar pode ser no construtor, ou você pode chamar depois que o construtor é chamado.

O estilo padrão, expresso como dwStylepassando – 1, é realmente WS_SYSMENU|WS_POPUP|WS_CAPTION|DS_MODALFRAME|DS_CONTEXTHELP| WS_VISIBLE.O estilo padrão estendido da janela, expresso como dwExStylepassando 0, é realmente WS_EX_DLGMODALFRAME.

A função de membro de Criar retorna imediatamente depois de criar a folha de propriedades.Para destruir a folha de propriedades, chame CWnd::DestroyWindow.

Folhas de propriedade sem-modo exibidas com uma chamada a Criar não têm OK, não o cancelarem, não se aplicam os botões agora, e da ajuda como as folhas de propriedade modais precisam.Os botões desejados devem ser criados pelo usuário.

Para exibir uma folha de propriedades modal, chame DoModal em vez de isso.

Exemplo

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