Vcl.Forms.TCustomForm.ShowModal
Delphi
function ShowModal: Integer; virtual;
C++
virtual int __fastcall ShowModal(void);
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TCustomForm |
Beschreibung
Zeigt das Formular als modales Dialogfeld an.
Mit ShowModal können Sie ein Formular modal anzeigen. Da bei einem modalen Formular die Anwendung unterbrochen wird, bis der Benutzer das Fenster wieder schließt, gibt ShowModal die Steuerung erst nach dem Schließen des Formulars zurück. Dabei wird auch der Wert der Eigenschaft ModalResult zurückgegeben.
Um ein modales Formular zu schließen, setzen Sie seine Eigenschaft ModalResult auf einen Wert ungleich 0.
Anmerkung: Wenn das Formular Schaltflächen enthält, deren Eigenschaft ModalResult einen anderen Wert als mrNone hat, wird es beim Klicken auf eine dieser Schaltflächen automatisch geschlossen, und ShowModal gibt den Wert von ModalResult zurück.
Sie können den Rückgabewert mit Hilfe der globalen Funktionen IsAbortResult, IsAnAllResult, IsNegativeResult und IsPositiveResult mit häufig verwendeten Werten vergleichen.