Vcl.StdCtrls.TCustomButton.ModalResult
Delphi
property ModalResult: TModalResult read FModalResult write FModalResult default 0;
C++
__property System::Uitypes::TModalResult ModalResult = {read=FModalResult, write=FModalResult, default=0};
Inhaltsverzeichnis
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". |
|
|
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". |
|
|
mrNoToAll |
mrAll +1 (13 oder $D) |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Nein für alle". |
|
|
mrYesToAll |
mrNoToAll +1 (14 oder $E) |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ja für alle". |
|
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