FMX.StdCtrls.TCustomButton.ModalResult

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

mrNone

0

Keine. Wird als Vorgabewert verwendet, bevor der Benutzer das Dialogfeld schließt.

mrOk

idOK = 1

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "OK".

mrCancel

idCancel = 2

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Abbrechen".

mrAbort

idAbort = 3

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Abbruch".

mrRetry

idRetry = 4

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Wiederholen".

mrIgnore

idIgnore = 5

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ignorieren".

mrYes

idYes = 6

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Ja".

mrNo

idNo = 7

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Nein".

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".

mrTryAgain

idTryAgain = 10

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Erneut versuchen".

mrContinue

idContinue = 11

Der Benutzer schließt das Dialogfeld mit der Schaltfläche "Weiter".

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 "Alle Nein".

mrYesToAll

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.

Siehe auch