public virtual int DoModal ( );
Valor de retorno
IDOK ou IDCANCEL se a função foi bem-sucedida; caso contrário, 0 ou -1. Se a folha foi estabelecida como um assistente (consulte SetWizardMode), DoModal retornará ID_WIZFINISH ou IDCANCEL.
Observações
Chame essa função de membro para exibir umPlanilha de propriedades restrita. O valor de retorno corresponde à identificação do Controlarar que fechado planilha de propriedades. Após essa função retorna, os windows correspondente para a folha de propriedades e todas as páginas serão destruídas. Os próprios objetos ainda existirá. Normalmente, você irá recuperar dados dos objetos de CPropertyPage depois DoModal retorna IDOK.
Para exibir umPlanilha de propriedades sem janela restrita, chame criar em vez disso.
&Notanbsp; A primeira vez que uma página de propriedade é criada a partir seu recurso caixa de diálogo correspondente, pode causar uma exceção de primeiro chance. Este é um resultado da página de propriedades, alterar o estilo do recurso caixa de diálogo para o estilo necessário antes para criar a página. Como os recursos são geralmente somente leitura, isso faz com que uma exceção. A exceção é tratada pelo sistema, e uma cópia do recurso pela é feita automaticamente pelo sistema. A exceção de primeiro chance, portanto, pode ser ignorada.
Uma vez que essa exceção deve ser tratada pelo sistema operacional, não envolver chamadas para CPropertySheet:: DoModal com um C++ tente/catch bloquear em que a captura manipula Tudo as exceções, por exemplo, catch (...) . Isto irá tratar a exceção para o sistema operacional, causando um comportamento imprevisível. Uso de exceção de C++ manipulação com tipos específicos de exceção ou usar manipulação de exceção estruturada onde a exceção de violação de acesso é passada para o sistema operacional é segura, no entanto.
Visão geral de CPropertySheet | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CDialog::DoModal, CPropertySheet::Create