CPropertySheet::Create

Artículo
02/19/2013

Muestra una hoja de propiedades no modal.

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

Parámetros

pParentWnd
Señala la ventana primaria.si NULL, elemento primario es el escritorio.
dwStyle
Estilos de ventana de la hoja de propiedades.Para obtener una lista completa de estilos disponibles, vea Estilos de ventana.
dwExStyle
Estilos de ventana extendidas de la hoja de propiedades.Para obtener una lista completa de estilos disponibles, vea Estilos de ventana extendidas

Valor devuelto

Distinto de cero si la hoja de propiedades se crea correctamente; si no 0.

Comentarios

La llamada a Crear puede estar dentro del constructor, o puede llamarlo después de invocar el constructor.

el estilo predeterminado, expresado pasando – 1 como dwStyle, es realmente WS_SYSMENU|WS_POPUP|WS_CAPTION|DS_MODALFRAME|DS_CONTEXTHELP| WS_VISIBLE.El estilo de ventana extendida predeterminada, expresado pasando 0 como dwExStyle, es realmente WS_EX_DLGMODALFRAME.

La función miembro de Crear vuelve inmediatamente después de crear la hoja de propiedades.Para destruir la hoja de propiedades, llame a CWnd:: DestroyWindow.

Las hojas de propiedades no modal mostradas con una llamada a Crear no tienen OK, delete, no se aplican Now, botones y de Ayuda igual que las hojas de propiedades modales.los botones deseados se deben crear por el usuario.

Para mostrar una hoja de propiedades modal, llame a DoModal en su lugar.

Ejemplo

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