Vcl.Forms.TCustomForm.ShowModal

Übergeordnet: TCustomForm

Delphi

function ShowModal: Integer; virtual;

C++

virtual int __fastcall ShowModal(void);

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung
- 2.1 Siehe auch
- 2.2 Codebeispiele

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.