FMX.StdCtrls.TCustomButton.ModalResult
Delphi
property ModalResult: TModalResult read FModalResult write FModalResult default mrNone;
C++
__property System::Uitypes::TModalResult ModalResult = {read=FModalResult, write=FModalResult, default=0};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | public | FMX.StdCtrls.pas FMX.StdCtrls.hpp |
FMX.StdCtrls | TCustomButton |
Beschreibung
Legt fest, ob und wie die Schaltfläche das übergeordnete (modale) Formular schließt.
Mit der Eigenschaft ModalResult einer Schaltfläche können Sie auf einfache Weise festlegen, dass durch Klicken auf die Schaltfläche das übergeordnete modale Formular geschlossen wird. Als Reaktion auf einen Klick wird die Eigenschaft ModalResult des übergeordneten Formulars auf den gleichen Wert wie die Eigenschaft ModalResult der Schaltfläche gesetzt.
Beispielsweise könnten die ModalResult-Eigenschaften zweier Schaltflächen (OK und Abbrechen) in einem Dialogfeld zur Entwurfszeit auf mrOk bzw. mrCancel gesetzt werden. Zur Laufzeit wird durch Klicken auf die Schaltfläche OK die Eigenschaft ModalResult des Dialogfeldes in mrOk und durch Klicken auf die Schaltfläche Abbrechen die Eigenschaft ModalResult des Dialogfeldes in mrCancel geändert. Wenn keine weitere Verarbeitung erforderlich ist, werden für diese Schaltflächen keine OnClick-Ereignisbehandlungsroutinen benötigt.
Die folgende Tabelle enthält die in der Unit System.UITypes definierten Konstanten, die für die Eigenschaft ModalResult mit dem Typ TModalResult verwendet werden sollen.
| Konstante | Wert | Bedeutung |
|---|---|---|
|
|
0 |
Keine. Wird als Vorgabewert verwendet, bevor der Benutzer das Dialogfeld schließt. |
|
|
idOK = 1 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "OK". |
|
|
idCancel = 2 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Abbrechen". |
|
|
idAbort = 3 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Abbruch". |
|
|
idRetry = 4 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Wiederholen". |
|
|
idIgnore = 5 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ignorieren". |
|
|
idYes = 6 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ja". |
|
|
idNo = 7 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Nein". |
|
|
idClose = 8 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Schließen". |
|
|
idHelp = 9 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Hilfe". |
|
|
idTryAgain = 10 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Erneut versuchen". |
|
|
idContinue = 11 |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Weiter". |
|
|
mrContinue + 1 (12 oder $C) |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Alle". |
|
|
mrAll +1 (13 oder $D) |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Alle Nein". |
|
|
mrNoToAll +1 (14 oder $E) |
Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Alle Ja". |
Sie können einen ModalResult-Wert mit den globalen Funktionen IsAbortResult, IsAnAllResult, IsNegativeResult oder IsPositiveResult überprüfen und mit der Funktion StripAllFromResult ModalResult-Werte, die sich auf "Alle"-Schaltflächen beziehen, konvertieren, um Werte zu erhalten, die den einfachen Schaltflächen (OK, Nein oder Ja) entsprechen.