Clase de CPropertySheet

Artículo
03/15/2013

representa las hojas de propiedades, también conocidas como cuadros de diálogo de la ficha.

class CPropertySheet : public CWnd

Miembros

Constructores públicos

Name	Descripción
CPropertySheet::CPropertySheet	Crea un objeto CPropertySheet.

Métodos públicos

Name	Descripción
CPropertySheet::AddPage	agrega una página a la hoja de propiedades.
CPropertySheet::Construct	Crea un objeto CPropertySheet.
CPropertySheet::Create	Muestra una hoja de propiedades no modal.
CPropertySheet::DoModal	Muestra una hoja de propiedades modal.
CPropertySheet::EnableStackedTabs	Indica si la hoja de propiedades usar pestañas apilado o de desplazamiento.
CPropertySheet::EndDialog	finaliza la hoja de propiedades.
CPropertySheet::GetActiveIndex	recupera el índice de la página activa de la hoja de propiedades.
CPropertySheet::GetActivePage	devuelve el objeto de la página activa.
CPropertySheet::GetPage	recupera un puntero a la página especificada.
CPropertySheet::GetPageCount	recupera el número de páginas en la hoja de propiedades.
CPropertySheet::GetPageIndex	recupera el índice de la página especificada de la hoja de propiedades.
CPropertySheet::GetTabControl	Recupera un puntero a un control de ficha.
CPropertySheet::MapDialogRect	Convierte las unidades de cuadro de diálogo de un rectángulo en unidades de la pantalla.
CPropertySheet::OnInitDialog	reemplace para aumentar la inicialización de la hoja de propiedades.
CPropertySheet::PressButton	Simula la elección del botón especificado en una hoja de propiedades.
CPropertySheet::RemovePage	quita una página de la hoja de propiedades.
CPropertySheet::SetActivePage	Establezca mediante programación el objeto de la página activa.
CPropertySheet::SetFinishText	Establece el texto para el botón de final.
CPropertySheet::SetTitle	Establece la leyenda de la hoja de propiedades.
CPropertySheet::SetWizardButtons	Habilita los botones del asistente.
CPropertySheet::SetWizardMode	habilita el modo de asistente.

Miembros de datos públicos

Name	Descripción
CPropertySheet::m_psh	la estructura de Windows PROPSHEETHEADER .Proporciona acceso a los parámetros básicos de la hoja de propiedades.

Comentarios

Una hoja de propiedades consta de un objeto de CPropertySheet y uno o más objetos de CPropertyPage .El marco muestra una hoja de propiedades como una ventana con un conjunto de índices de la ficha y un área que contiene la página actualmente seleccionado.El usuario navega a una página determinada mediante la ficha adecuada.

CPropertySheet proporciona compatibilidad para la estructura expandida de PROPSHEETHEADER introdujo en Windows 98 y Windows NT 2000.La estructura contiene marcas adicionales y miembros que admiten mediante un mapa de bits de fondo de “marca de agua”.

Para mostrar estas nuevas imágenes automáticamente en el objeto de hoja de propiedades, pase los valores válidos para las imágenes de mapa de bits y la paleta de la llamada a CPropertySheet:: construcción o a CPropertySheet:: CPropertySheet.

aunque CPropertySheet no es derivado de CDialog, administrar un objeto de CPropertySheet es como administrar un objeto de CDialog .Por ejemplo, la creación de una hoja de propiedades requiere construcción dividida en dos partes: llame al constructor, y llame a DoModal para una hoja de propiedades modal o Crear para una hoja de propiedades no modal.CPropertySheet tiene dos tipos de constructores: CPropertySheet:: construcción y CPropertySheet:: CPropertySheet.

Cuando se crea un objeto de CPropertySheet , algún Estilos de ventana puede hacer una excepción de primera oportunidad que aparezca.Esto resulta del sistema que intenta cambiar el estilo de la hoja de propiedades antes de crear la hoja.Para evitar esta excepción, asegúrese de establecer los estilos siguientes cuando se crea CPropertySheet:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Los estilos siguientes son opcionales, y no producirán excepciones de primera oportunidad:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Se prohíbe cualquier otro Window Styles y no debe habilitarlas.

intercambiar datos entre un objeto de CPropertySheet y un objeto externo es similar a intercambiar datos con un objeto de CDialog .La diferencia importante es que los valores de una hoja de propiedades son normalmente variables miembro de los objetos de CPropertyPage en lugar del propio objeto de CPropertySheet .

Puede crear un tipo de cuadro de diálogo de la ficha denominado un asistente, que consta de una hoja de propiedades con una secuencia de páginas de propiedades destinados a través de los pasos de una operación, como configuración de un dispositivo o crear un boletín.En un cuadro de diálogo de la ficha del asistente-tipo, las páginas de propiedades no tienen pestañas, y sólo una página de la propiedad es visible al mismo tiempo.Además, en lugar de tener botones de Aceptar y de Aplicar ahora , un cuadro de diálogo de la ficha del asistente-tipo tiene un botón de Atrás , botón de Siguiente o de Finalizar , botón de Cancelar , y un botón de Ayuda .

Para crear un cuadro de diálogo de asistente-tipo, siga los mismos pasos que se usa para crear una hoja de propiedades estándar, pero la llamada SetWizardMode antes de llamar a DoModal.Para habilitar los botones del asistente, llame a SetWizardButtons, utilizando los marcadores para personalizar su función y aspecto.Para habilitar el botón de Finalizar , la llamada SetFinishText después de que el usuario ha realizado medidas en la última página del asistente.

Para obtener más información sobre cómo utilizar los objetos de CPropertySheet , vea el artículo hojas de propiedades y páginas de propiedades.También, vea el artículo Q146916 de Knowledge Base: HOWTO: Cree un no modal CPropertySheet con botones estándar y el caso Q300606: HOWTO: diseñar una hoja de propiedades de Resizable MFC.