CPropertySheet::criar

Artigo
08/25/2010

Exibe uma sem janela restrita propriedade folha.

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

Parâmetros

pParentWnd
Aponta para a janela pai.If NULO, pai é a área de trabalho.
dwStyle
Janela estilos para folha de propriedades.Para obter uma lista completa de estilos disponível, consulte Estilos de janela.
dwExStyle
Estendido janela estilos para folha de propriedades.Para obter uma lista completa de estilos disponível, consulte Estilos de janela estendido

Valor de retorno

Diferente de zero se o folha de propriedades é criado com êxito; caso contrário, 0.

Comentários

A telefonar para Criar pode ser dentro do construtor, ou você pode chamá-lo depois que o construtor é invocado.

O estilo padrão, expresso pela passagem de – 1 sistema autônomo dwStyle, na verdade é WS_SYSMENU | WS_POPUP | WS_CAPTION | DS_MODALFRAME | DS_CONTEXTHELP | WS_VISIBLE.O padrão de estilo de janela, expresso, passando 0 sistema autônomo estendidodwExStyle, na verdade é WS_EX_DLGMODALFRAME.

The Criarfunção de membro retorna imediatamente após a criação de folha de propriedades.Para destruir o propriedade folha, telefonar CWnd::DestroyWindow.

Sem janela restrita propriedade folhas exibidas com uma telefonar para Criar não possui botões OK, Cancelar, aplicar agora e ajuda sistema autônomo modal propriedade folhas fazer.Botões desejado devem ser criado pelo usuário.

Para exibir uma folha de propriedades modal, chamar DoModal em vez disso.

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