FMX.Forms.TCommonCustomForm.ShowModal

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ShowModal: TModalResult; overload;
procedure ShowModal(const ResultProc: TProc<TModalResult>); overload;

C++

System::Uitypes::TModalResult __fastcall ShowModal()/* overload */;
void __fastcall ShowModal(const System::DelphiInterface<System::Sysutils::TProc__1<System::Uitypes::TModalResult> > ResultProc)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
FMX.Forms.pas
FMX.Forms.hpp
FMX.Forms TCommonCustomForm


Beschreibung

Zeigt das Formular als modales Dialogfeld an.

Mit ShowModal zeigen Sie das Formular als modales Dialogfeld an. Wenn ein modales Formular geöffnet wird, wird die Anwendung unterbrochen, bis der Benutzer das modale Formular schließt. Daher gibt ShowModal die Steuerung erst nach dem Schließen des Formulars zurück. Beim Schließen des Formulars wird der Wert der Eigenschaft ModalResult zurückgegeben.

Setzen Sie zum Schließen eines modalen Formulars die Eigenschaft ModalResult auf einen Wert ungleich null.

Tipp: Wenn das Formular Schaltflächen enthält, deren Eigenschaft ModalResult auf einen Wert ungleich mrNone gesetzt ist, wird es beim Klicken auf eine dieser Schaltflächen automatisch geschlossen, und ModalResult gibt den Wert von ShowModal zurück.

Achtung: Modale Dialogfelder werden in Android-Apps nicht unterstützt. Die Verwendung modaler Dialogfelder wird auf keiner mobilen Plattform (iOS und Android) empfohlen, weil sie zu unerwartetem Verhalten führen können. Durch den Verzicht auf modale Dialogfelder vermeiden Sie mögliche Probleme beim Debuggen und bei der Unterstützung Ihrer mobilen Apps.

Siehe auch