virtual int DoModal ( );
Rückgabewert
IDOK oder IDCANCEL wenn die Funktion erfolgreich war; andernfalls 0 oder 1. Wenn das Eigenschaftenblatt als Assistent hergestellt wurde (siehe SetWizardMode), DoModal zurückgegeben, entweder ID_WIZFINISH oder IDCANCEL.
Bemerkungen
Rufen Sie diese Memberfunktion um einen modalen Eigenschaftenblatt anzuzeigen. Der Rückgabewert entspricht der ID des Steuerelements, die im Eigenschaftsfenster geschlossen. Nachdem diese Funktion zurückgibt, werden die Windows entsprechend dem Eigenschaftenblatt und alle Seiten zerstört wurden. Die Objekte selbst ist noch vorhanden. In der Regel werden Sie Abrufen von Daten aus den CPropertyPage -Objekten nachdem DoModal IDOK zurückgegeben.
Um ein nicht modales Eigenschaftenblatt anzuzeigen, rufen Sie stattdessen Erstellen.
Hinweis&Nbsp; Zum ersten Mal, das eine Eigenschaftenseite aus seiner entsprechenden Dialogfeldressource erstellt wird, kann es eine Ausnahme der ersten Chance verursachen. Dies ist ein Ergebnis der Eigenschaftenseite ändern den Stil der die Ressource an den gewünschten Stil vor dem Erstellen der Seite. Da Ressourcen im Allgemeinen schreibgeschützt sind, bewirkt dies eine Ausnahme. Die Ausnahme wird vom System behandelt, und eine Kopie der geänderten Ressource erfolgt automatisch durch das System. Die erste Chance Ausnahme kann somit ignoriert werden.
Da diese Ausnahme vom Betriebssystem behandelt werden muss, nicht umbrochen werden Aufrufe von CPropertySheet::DoModal mit C++ versuchen/catch- block in dem der Fang behandelt alle Ausnahmen, z. B. catch (...) . Dies behandelt die Ausnahme für das Betriebssystem, unvorhersehbares Verhalten verursacht bestimmt. Verwenden von C++-Ausnahme behandeln mit bestimmte Ausnahmetypen oder verwenden die strukturierte Ausnahmebehandlung, wo wird die Zugriffsverletzung Ausnahme an das Betriebssystem übergeben ist jedoch sicher,.
CPropertySheet Übersicht | Member der Klasse | Hierarchiediagramm
Siehe auch&Nbsp;CDialog::DoModal, CPropertySheet::Create