CPropertySheet::DoModal
Wyświetla arkusz właściwości modalny.
virtual INT_PTR DoModal();
Wartość zwracana
IDOKlub IDCANCEL , jeśli funkcja zakończyła się pomyślnie; w przeciwnym razie 0 lub wartość-1.Jeśli arkusz właściwości ustanowiono jako kreatora (zobacz SetWizardMode), DoModal albo zwraca ID_WIZFINISH lub IDCANCEL.
Uwagi
Zwracana wartość odpowiada identyfikator zamknięcia w arkuszu właściwości formantu.Po powrocie z tej funkcji windows odpowiadające arkusz właściwości i wszystkie strony będzie zostały zniszczone.Same obiekty będą nadal istnieje.Zazwyczaj będzie pobierać dane z CPropertyPage obiektów po DoModal zwraca IDOK.
Aby wyświetlić arkusz właściwości niemodalny, call Tworzenie zamiast.
Strona właściwości jest tworzona z jego odpowiednie okno dialogowe zasób, może spowodować wyjątek pierwszej szansy.Wynika to z strony właściwości, zmiana stylu zasobu, okno dialogowe Styl wymagane przed utworzeniem strony.Ponieważ zasoby są zwykle tylko do odczytu, powoduje wyjątek.System obsługuje wyjątek i tworzy kopię zmodyfikowanych zasobów.Wyjątek pierwszej szansy, dlatego można zignorować.
[!UWAGA]
Wyjątek ten musi być obsługiwane przez system operacyjny, jeśli kompilacja odbywa się z modelem obsługi wyjątków asynchronicznego.Aby uzyskać więcej informacji na temat modeli obsługi wyjątków, zobacz /Eh (Model obsługi wyjątków).W takim przypadku nie Zawijaj wywołania CPropertySheet::DoModal z bloku try-catch języka C++ w którym połowu obsługuje wszystkie wyjątki, na przykład catch (...).Ten blok byłoby obsłużyć wyjątek przeznaczonych dla systemu operacyjnego i przyczyna nieprzewidywalne.Jednak bezpiecznie użyć obsługi wyjątków określonych typów lub structured exception handling, gdzie przeszła wyjątek naruszenia dostępu do systemu operacyjnego wyjątków C++.
Aby uniknąć generowania tego wyjątku pierwszej szansy, można ręcznie gwarantować że arkusz właściwości ma prawidłowe Style okien.Należy ustawić następujące style arkusz właściwości:
DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP
Bez powodowania wyjątek pierwszej szansy, można użyć następujących stylów opcjonalne:
DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN
Wyłączyć inne style Windows, ponieważ nie są one zgodne z arkusze właściwości.Te porady nie dotyczą extended style.Ustawienie tych standardowych stylów odpowiednio gwarantuje, że arkusz właściwości nie muszą zostać zmodyfikowane i pozwoli uniknąć generowania wyjątków pierwszej szansy.
Przykład
Zobacz przykład dla CPropertySheet::AddPage.
Wymagania
Nagłówek: afxdlgs.h