virtual int DoModal ( );
Valore restituito
IDOK o IDCANCEL se la funzione è stata completata; in caso contrario 0 o -1. Se la finestra delle proprietà è stata istituita come una procedura guidata (vedi SetWizardMode), DoModal restituisce ID_WIZFINISH o IDCANCEL.
Osservazioni
Chiamare questa funzione membro per visualizzare una finestra delle proprietà modale. Il valore restituito corrisponde all'ID del controllo che ha chiuso la finestra delle proprietà. Dopo questa funzione restituisce, le finestre corrispondente alla finestra delle proprietà e tutte le pagine saranno sono stati distrutti. Esisteranno ancora gli oggetti stessi. In genere, sarà recuperare dati dagli oggetti CPropertyPage dopo DoModal restituisce IDOK.
Per visualizzare una finestra delle proprietà non modale, chiamare invece Create.
&Notanbsp; La prima volta che una pagina delle proprietà viene creata dal suo corrispondente risorsa di dialogo, esso può causare un'eccezione first-chance. Questo è un risultato della pagina delle proprietà cambiando lo stile della finestra di dialogo stile richiesto prima di creare la pagina. Perché le risorse sono generalmente di sola lettura, questo provoca un'eccezione. L'eccezione viene gestita dal sistema, e una copia della risorsa modificata è fatto automaticamente dal sistema. Le eccezioni first-chance così possono essere ignorato.
Dal momento che questa eccezione deve essere gestita dal sistema operativo, non avvolgere le chiamate a CPropertySheet::DoModal con un C++ provare/catturare blocchi in cui le catture gestisce tutte le eccezioni, ad esempio, catch (...) . Questo in grado di gestire l'eccezione destinato al sistema operativo, causando il comportamento imprevedibile. Utilizzo di eccezione C++ maneggiano con tipi di eccezione specifica o utilizzando la gestione delle eccezioni strutturata dove l'eccezione di violazione di accesso viene fatta passare attraverso il sistema operativo è sicuro, tuttavia.
CPropertySheet pa&noramica |nbsp; Membri della classe | Gerarchia Chart
Vedere a&nchenbsp;CDialog::DoModal, CPropertySheet::Create