CPropertySheet::DoModal
Zobrazí modální okno vlastností.
virtual INT_PTR DoModal();
Vrácená hodnota
IDOKnebo IDCANCEL Pokud funkce byla úspěšná. jinak 0 nebo -1.Pokud bylo zjištěno vlastností jako průvodce (viz SetWizardMode), DoModal buď vrátí ID_WIZFINISH nebo IDCANCEL .
Poznámky
Vrácená hodnota odpovídá ID ovládacího prvku, který je uzavřen vlastností.Po vrací tato funkce windows odpovídající vlastností a všechny stránky budou byly zničeny.Samotnými objekty bude stále existovat.Obvykle bude načítat data z CPropertyPage objekty po DoModal vrátí IDOK .
Zobrazit nemodální vlastností, volání vytvořit místo.
Při vytvoření stránky vlastností z jeho odpovídajícího zdroje v dialogovém okně může způsobit výjimku první možnost.To vyplývá ze stránky vlastností před vytvořením stránky Změna stylu prostředku dialogovém okně na požadovaný styl.Protože prostředky jsou obecně pouze pro čtení, to způsobí výjimku.Systém zpracovává výjimku a vytvoří kopii změněné zdroje.Proto lze ignorovat výjimky první možnost.
[!POZNÁMKA]
Tuto výjimku musí být zpracovány operačním systémem, pokud jsou kompilace modelu zpracování výjimek asynchronní.Další informace o modely zpracování výjimek, viz /EH (Model zpracování výjimek).V tomto případě není zalomen volání CPropertySheet::DoModal bloku try-catch C++ s jakým úlovku zpracovává všechny výjimky, například catch (...) .Tento blok by zpracovat výjimku určených pro operační systém a způsobit nepředvídatelné chování.Zpracování výjimek pro konkrétní typy nebo structured exception handling kde výjimku narušení přístupu prochází operační systém výjimek C++ však může bez obav použít.
Aby nedošlo k vygenerování tuto výjimku první možnost, můžete ručně zaručit seznam vlastností obsahuje správný Styly oken.Je nutné nastavit následující styly pro list vlastností:
DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP
Můžete použít následující volitelné styly bez výjimky první možnost:
DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN
Jiné styly Windows zakážete, protože nejsou kompatibilní s vlastností.Toto doporučení se nevztahuje na rozšířené styly.Nastavení těchto standardních stylů vhodně zaručí, že vlastností není nutné měnit a vyhnout se generuje výjimku první možnost.
Příklad
Příklad pro CPropertySheet::AddPage.
Požadavky
Záhlaví: afxdlgs.h