Vcl.StdCtrls.TButton.ModalResult
Delphi
property ModalResult: TModalResult read FModalResult write FModalResult default 0;
C++
__property ModalResult = {default=0};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | published | Vcl.StdCtrls.pas Vcl.StdCtrls.hpp |
Vcl.StdCtrls | TButton |
Beschreibung
Legt fest, ob und wie die Schaltfläche das (modale) übergeordnete Formular schließt.
Vcl.StdCtrls.TButton.ModalResult erbt von Vcl.StdCtrls.TCustomButton.ModalResult. Der folgende Inhalt bezieht sich auf Vcl.StdCtrls.TCustomButton.ModalResult.
Legt fest, ob und wie die Schaltfläche das (modale) übergeordnete Formular schließt.
Die Eigenschaft ModalResult einer Schaltflächenkomponente bietet eine einfache Möglichkeit, durch das Anklicken einer Schaltfläche ein modales Formular zu schließen. 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. Zur Laufzeit setzt dann ein Klick auf die Schaltfläche OK die Eigenschaft ModalResult des Dialogfeldes auf mrOk. Die Schaltfläche Abbrechen bewirkt dann entsprechend die Einstellung mrCancel. Wenn keine weiteren Verarbeitungsschritte erforderlich sind, werden für diese Schaltflächen keine Ereignisbehandlungsroutinen benötigt.
Die folgenden Konstanten des Typs TModalResult sind für die Eigenschaft ModalResult definiert:
| Konstante | Wert | Bedeutung |
|---|---|---|
|
mrNone |
0 |
Keine. Wird als Vorgabewert verwendet, bevor der Benutzer das Dialogfeld verlässt. |
|
mrOk |
idOK |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche OK. |
|
mrCancel |
idCancel |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Abbrechen. |
|
mrAbort |
idAbort |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Abbruch. |
|
mrRetry |
idRetry |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Wiederholen. |
|
mrIgnore |
idIgnore |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Ignorieren. |
|
mrYes |
idYes |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Ja. |
|
mrNo |
idNo |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Nein |
|
mrAll |
mrNo + 1 |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Alle. |
|
mrNoToAll |
mrAll + 1 |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche "Nein für alle". |
|
mrYesToAll |
mrNoToAll + 1 |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche "Ja für alle". |
|
mrClose |
mrYesToAll + 1 |
Der Benutzer verlässt das Dialogfeld mit der Schaltfläche Schließen. |