Vcl.Forms.TCustomForm.ShowModal

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ShowModal: Integer; virtual;

C++

virtual int __fastcall ShowModal(void);

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.

Siehe auch

Codebeispiele