Aracılığıyla paylaş


CPropertySheet::DoModal

Kalıcı özellik sayfasını görüntüler.

virtual INT_PTR DoModal();

Dönüş Değeri

IDOKya da IDCANCEL işlevi; başarılı olursa Aksi halde 0 veya -1.Bir sihirbaz kuruldu özellik sayfasını (bkz: SetWizardMode), DoModal ya da verir ID_WIZFINISH veya IDCANCEL.

Notlar

Dönüş değeri, denetimin özellik sayfasını kapalı Kimliğine karşılık gelir.Bu işlev dönüşünden sonra özellik sayfasını ve tüm sayfalarına karşılık gelen windows yok.Nesneleri varolmaya devam eder.Tipik olarak, verileri alır CPropertyPage sonra nesneleri DoModal döndüren IDOK.

Kalıcı olmayan özellik sayfasını görüntülemek için arama Create onun yerine.

Özellik sayfasıyla ilişkili iletişim kaynaktan oluşturulduğunda, ilk şans özel durum neden olabilir.Bu özellik sayfasında sayfa oluşturulmadan önce gerekli stili stil iletişim kaynağının değiştirilmesi neden olur.Kaynaklar genellikle salt okunur olduğundan bu bir özel duruma neden olur.Sistem özel durumu işler ve değiştirilen kaynak bir kopyasını oluşturur.Bu nedenle ilk şans özel durum sayılabilir.

[!NOT]

Zaman uyumsuz bir özel durum işleme modeli ile derleme, bu durum işletim sistemi tarafından işlenmeli.Özel durum işleme modelleri hakkında daha fazla bilgi için bkz: /eh (özel durum işleme modeli).Bu durumda, yapılan çağrıların kaydırılacak CPropertySheet::DoModal C++ try-catch bloğu ile catch işleme tüm özel durumları, örneğin, catch (...).Bu blok işletim sistemi ve öngörülemeyen davranışlara neden için hedeflenen özel durumunu işlemesi.Ancak, C++ özel erişim ihlali özel durumu ile işletim sistemi geçirildiği belirli bir özel durum türleri ya da yapılandırılmış özel durum işleme işleme güvenle kullanabilirsiniz.

Bu ilk şans istisna oluşturmamak için el ile özellik sayfası doğru olduğunu garanti edebileceðiniz Pencere stilleri.Bir özellik sayfası için aşağıdaki stiller ayarlamanız gerekir:

  • DS_3DLOOK

  • DS_CONTROL

  • WS_CHILD

  • WS_TABSTOP

İlk şans özel durum neden olmadan aşağıdaki isteğe bağlı stilleri kullanabilirsiniz:

  • DS_SHELLFONT

  • DS_LOCALEDIT

  • WS_CLIPCHILDREN

Tüm diğer Windows stilleri özellik sayfaları ile uyumlu olmadığı için devre dışı.Bu öneriler, genişletilmiş stiller uygulanmaz.Bu standart stilleri uygun şekilde ayarlayarak, özellik sayfasında değiştirilecek yoktur ve ilk şans istisna oluşturmamak olduğunu garanti edemez.

Örnek

Örnek için bkz: CPropertySheet::AddPage.

Gereksinimler

Başlık: afxdlgs.h

Ayrıca bkz.

Başvuru

CPropertySheet sınıfı

Hiyerarşi grafik

CDialog::DoModal

CPropertySheet::Create