virtual int DoModal ( );
Valor devuelto
IDOK o IDCANCEL si la función se realizó correctamente; en caso contrario 0 o -1. Si la hoja de propiedades se ha establecido como un asistente (véase SetWizardMode), DoModal devuelve ID_WIZFINISH o IDCANCEL.
Observaciones
Llame a esta función miembro para mostrar una hoja de propiedad modal. El valor devuelto corresponde al identificador del control que cierra la hoja de propiedades. Después de esta función devuelve, habremos destruidas las ventanas correspondientes a la hoja de propiedades y todas las páginas. Los propios objetos seguirán existiendo. Normalmente, será recuperar datos de los objetos CPropertyPage después DoModal devuelve IDOK.
Para mostrar una hoja de propiedades no modales, llame a crear en su lugar.
&Notanbsp; La primera vez que se crea una página de propiedad de su recurso de cuadro de diálogo correspondiente, puede causar una excepción de primera oportunidad. Este es el resultado de la página de propiedades de cambiar el estilo de los recurso de cuadro de diálogo para el estilo requerido antes de crear la página. Porque los recursos son generalmente de sólo lectura, esto produce una excepción. La excepción es controlado por el sistema, y una copia del recurso modificado es realizada automáticamente por el sistema. Por lo tanto puede ignorarse la excepción de primera oportunidad.
Dado que esta excepción debe ser manejada por el sistema operativo, no ajustar llamadas a CPropertySheet:: DoModal con C++ intente/atrapar bloquear en el que las capturas maneja todas las excepciones, por ejemplo, catch (...) . Esto controlará la excepción destinada para el sistema operativo, causando un comportamiento impredecible. El uso de excepciones de C++ con tipos de excepción específica o mediante control estructurado de excepciones donde la excepción de infracción de acceso se pasa a través del sistema operativo es seguro, sin embargo.
I&ntroducción a CPropertySheet |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambié&nnbsp;CDialog::DoModal, CPropertySheet::Create