FMX.Forms.TCommonCustomForm.ShowModal

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
function public
FMX.Forms.pas
FMX.Forms.hpp
FMX.Forms TCommonCustomForm


Description

Affiche la fiche sous forme de boîte de dialogue modale.

Utilisez ShowModal pour afficher la fiche sous la forme d'une boîte de dialogue modale. Quand une fiche modale est ouverte, l'application ne peut pas continuer à s'exécuter jusqu'à ce que la fiche modale soit fermée. Par conséquent, ShowModal ne renvoie rien jusqu'à la fermeture de la fiche. A la fermeture de la fiche, la valeur de la propriété ModalResult est renvoyée.

Pour fermer une fiche modale, définissez sa propriété ModalResult sur une valeur différente de zéro.

Conseil : Si la fiche contient des boutons dont la propriété ModalResult est définie sur une valeur autre que mrNone, la fiche se ferme automatiquement lorsque l'utilisateur clique sur l'un de ces boutons et renvoie la valeur de ModalResult comme valeur de renvoi de ShowModal.

Attention : Les boîtes de dialogue modales ne sont pas prise en charge dans les applications Android. Au lieu d'appeler ShowModal, il est préférable d'appeler Show, et que la fiche renvoie et appelle votre événement. Il est recommandé de ne pas utiliser de boîtes de dialogue modales sur aucune des plates-formes mobiles (iOS et Android), car elles peuvent produire des résultats inattendus. En n'utilisant pas de boîte de dialogue modale, vous évitez les potentiels problèmes liés au débogage et à la prise en charge de vos applications mobiles.

Voir aussi