CPropertySheet::DoModal

Artigo
08/25/2010

Exibe uma janela restrita folha de propriedades.

virtual INT_PTR DoModal();

Valor de retorno

IDOK ou IDCANCEL Se a função foi bem-sucedida; caso contrário, 0 ou -1. Se o folha de propriedades foi estabelecida sistema autônomo um assistente (consulte SetWizardMode), DoModal Retorna um ID_WIZFINISH ou IDCANCEL.

Comentários

O valor retornado corresponde à ID do controle que fechou o folha de propriedades.Depois que essa função retorna, janelas correspondente a folha de propriedades e todas as páginas serão tiverem sido destruídas.Os objetos em si ainda existirá.Normalmente, você irá recuperar dados do CPropertyPage objetos depois DoModal Retorna IDOK.

Para exibir uma sem janela restrita folha de propriedades, telefonar Criar em vez disso.

Quando um página de propriedades é criado de seu recurso de diálogo correspondente, ele pode causar uma exceção de primeira chance.Isso resultados do propriedade página alterando o estilo de recurso caixa de diálogo para o estilo necessário antes que a página seja criada.Como os recursos são geralmente somente leitura, isso faz com que uma exceção.O sistema manipule a exceção e faz uma cópia de recursos modificados.A exceção de primeira chance, portanto, pode ser ignorada.

Observação:
T a exceção deve ser manipulada pelo sistema operacional Se você está compilando com o modelo de manipulação de exceções assíncrono.Para obter mais informações sobre modelos de manipulação de exceção, consulte /EH (modelo de Manipulação de exceção).Nesse caso, não Empacote as chamadas para CPropertySheet::DoModal com um bloco try-catch do C++ na qual o problema trata todas as exceções, por exemplo, catch (...). Esse bloco deve tratar a exceção direcionada para o sistema operacional e causa um comportamento imprevisível.No entanto, você pode usar com segurança a exceção de C++ lidar com tipos de exceção específica ou manipulação de exceção estruturada em que a exceção de violação de acesso é passada para o sistema operacional.

T a exceção deve ser manipulada pelo sistema operacional Se você está compilando com o modelo de manipulação de exceções assíncrono.Para obter mais informações sobre modelos de manipulação de exceção, consulte /EH (modelo de Manipulação de exceção).Nesse caso, não Empacote as chamadas para CPropertySheet::DoModal com um bloco try-catch do C++ na qual o problema trata todas as exceções, por exemplo, catch (...). Esse bloco deve tratar a exceção direcionada para o sistema operacional e causa um comportamento imprevisível.No entanto, você pode usar com segurança a exceção de C++ lidar com tipos de exceção específica ou manipulação de exceção estruturada em que a exceção de violação de acesso é passada para o sistema operacional.

Para evitar a geração dessa exceção de primeira chance, você pode manualmente garantir que o folha de propriedades tem o correto Estilos de janela. Você precisa conjunto os seguintes estilos para uma propriedade folha:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Você pode usar os seguintes estilos opcionais sem causar uma exceção de primeira chance:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Desabilitar todos os demais estilos do Windows porque não são compatível com propriedade folhas.Essa recomendação não se aplica estilos estendidos.Definir adequadamente esses estilos padrão garante que a folha de propriedades não tem a ser modificada e evitar a geração da exceção de primeira chance.