Vcl.StdCtrls.TCustomButton.ModalResult

• Übergeordnet: TCustomButton

Delphi

property ModalResult: TModalResult read FModalResult write FModalResult default 0;

C++

__property System::Uitypes::TModalResult ModalResult = {read=FModalResult, write=FModalResult, default=0};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
property	public	Vcl.StdCtrls.pas Vcl.StdCtrls.hpp	Vcl.StdCtrls	TCustomButton

Beschreibung

Legt fest, ob und wie die Schaltfläche das übergeordnete (modale) Formular schließt.

Mit der Eigenschaft ModalResult einer Schaltflächen-Komponente kann ein modales Formular einfach geschlossen werden, indem auf die Schaltfläche geklickt wird. Als Reaktion auf einen Klick wird die Eigenschaft ModalResult des übergeordneten Formulars auf denselben Wert gesetzt wie die Eigenschaft ModalResult der Schaltfläche.

Beispielsweise könnten die ModalResult-Eigenschaften zweier Schaltflächen ("OK" und Abbrechen) zur Entwurfszeit auf mrOk bzw. mrCancel gesetzt werden. Durch Klicken auf die Schaltfläche "OK" zur Laufzeit wird die Eigenschaft ModalResult des Dialogfeldes auf mrOk gesetzt. Durch Klicken auf die Schaltfläche Abbrechen wird die Eigenschaft ModalResult auf mrCancel gesetzt. Wenn keine weiteren Verarbeitungsschritte erforderlich sind, werden für diese Schaltflächen keine Ereignisbehandlungsroutinen benötigt.

Änderungen der ModalResult-Werte im XE2-Release

Im XE2-Release wurden drei neue ModalResult-Werte eingeführt: mrContinue, mrHelp und mrTryAgain.

Des Weiteren wurden vier der vorhandenen ModalResult-Werte in XE2 geändert. Wenn Sie in Ihren Anwendungen einen der folgenden vier ModalResult-Werte für TButton verwenden, müssen Sie Änderungen an Ihrem Code vornehmen: mrClose, mrAll, mrNoToAll und mrYesToAll. Da diese Werte als Zahlen in DFM-Dateien gespeichert werden, ändern sich die Werte bei der Migration eines Projekts nach XE2. Die Werte wurden folgendermaßen geändert:

• Vor XE2:
  • mrClose=11
  • mrAll=8
  • mrNoToAll=9
  • mrYesToAll=10
• In XE2:
  • mrClose=8
  • mrAll=12
  • mrNoToAll=13
  • mrYesToAll=14

In der folgenden Tabelle sind die Konstanten des Typs TModalResult, die für die Eigenschaft ModalResult definiert sind, zusammen mit ihren Werten im XE2-Release und XE-Release (d. h. alle Releases vor XE2) aufgeführt:

Konstante	Wert	Bedeutung	Unterstützte Releases
mrNone	0	Keine. Wird als Vorgabewert verwendet, bevor der Benutzer das Dialogfeld schließt.	Alle Releases
mrOk	idOK = 1	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "OK".	Alle Releases
mrCancel	idCancel = 2	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Abbrechen".	Alle Releases
mrAbort	idAbort = 3	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Abbruch".	Alle Releases
mrRetry	idRetry = 4	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Wiederholen".	Alle Releases
mrIgnore	idIgnore = 5	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ignorieren".	Alle Releases
mrYes	idYes = 6	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ja".	Alle Releases
mrNo	idNo = 7	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Nein".	Alle Releases
mrClose	idClose = 8	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Schließen".	In XE = 11 In XE2 = 8
mrHelp	idHelp = 9	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Hilfe".	Neu in XE2
mrTryAgain	idTryAgain = 10	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Erneut versuchen".	Neu in XE2
mrContinue	idContinue = 11	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Weiter".	Neu in XE2
mrAll	mrContinue + 1 (12 oder $C)	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Alle".	In XE = 8 In XE2 = 12
mrNoToAll	mrAll +1 (13 oder $D)	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Nein für alle".	In XE = 9 In XE2 = 13
mrYesToAll	mrNoToAll +1 (14 oder $E)	Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ja für alle".	In XE = 10 In XE2 = 14

Vollständige Informationen und Lösungen finden Sie im Artikel "XE2 values of mrAll, mrNoToAll, mrYesToAll and mrClose" unter http://www.bobswart.nl/Weblog/Blog.aspx?RootId=5:5029

Siehe auch

• TModalResult

Codebeispiele

• StdCtrlsProp (Delphi)
• StdCtrlsProp (C++)