FMX.StdCtrls.TCustomButton.ModalResult
Delphi
property ModalResult: TModalResult read FModalResult write FModalResult default mrNone;
C++
__property System::Uitypes::TModalResult ModalResult = {read=FModalResult, write=FModalResult, default=0};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| property | public | FMX.StdCtrls.pas FMX.StdCtrls.hpp |
FMX.StdCtrls | TCustomButton |
Description
Détermine si le choix de ce bouton ferme sa fiche parent (modale) et comment cette fermeture a lieu.
La définition de la propriété ModalResult d'un bouton est un moyen aisé pour faire en sorte qu'un clic sur le bouton provoque la fermeture d'une fiche modale parent. Quand l'utilisateur clique sur un bouton, la propriété ModalResult de sa fiche parent reçoit la même valeur que la propriété ModalResult d'un bouton.
Si, par exemple, une boîte de dialogue comporte les boutons OK et Cancel, leurs propriétés ModalResult peuvent être respectivement définies à la conception sur mrOk et mrCancel. A l'exécution, un clic sur le bouton OK change la valeur de la propriété ModalResult de la boîte de dialogue en mrOk, et un clic sur le bouton Cancel change la propriété ModalResult de la boîte de dialogue en mrCancel. Si aucun autre traitement n'est requis, aucun gestionnaire d'événement OnClick n'est requis pour les boutons.
Le tableau suivant liste les constantes définies dans l'unité System.UITypes à utiliser pour la propriété ModalResult de type TModalResult.
| Constante | Valeur | Signification |
|---|---|---|
|
|
0 |
Aucune. Utilisée comme valeur par défaut avant la sortie de l'utilisateur. |
|
|
idOK = 1 |
L'utilisateur est sorti en utilisant le bouton OK. |
|
|
idCancel = 2 |
L'utilisateur est sorti en utilisant le bouton CANCEL. |
|
|
idAbort = 3 |
L'utilisateur est sorti en utilisant le bouton ABORT. |
|
|
idRetry = 4 |
L'utilisateur est sorti en utilisant le bouton RETRY. |
|
|
idIgnore = 5 |
L'utilisateur est sorti en utilisant le bouton IGNORE. |
|
|
idYes = 6 |
L'utilisateur est sorti en utilisant le bouton YES. |
|
|
idNo = 7 |
L'utilisateur est sorti en utilisant le bouton NO. |
|
|
idClose = 8 |
L'utilisateur est sorti en utilisant le bouton CLOSE. |
|
|
idHelp = 9 |
L'utilisateur est sorti en utilisant le bouton HELP. |
|
|
idTryAgain = 10 |
L'utilisateur est sorti en utilisant le bouton TRY AGAIN. |
|
|
idContinue = 11 |
L'utilisateur est sorti en utilisant le bouton CONTINUE. |
|
|
mrContinue + 1 (12 ou $C) |
L'utilisateur est sorti en utilisant le bouton ALL. |
|
|
mrAll +1 (13 ou $D) |
L'utilisateur est sorti en utilisant le bouton NO TO ALL. |
|
|
mrNoToAll +1 (14 ou $E) |
L'utilisateur est sorti en utilisant le bouton YES TO ALL. |
Vous pouvez contrôler une valeur ModalResult à l'aide des fonctions globales IsAbortResult, IsAnAllResult, IsNegativeResult ou IsPositiveResult, et utiliser la fonction StripAllFromResult pour convertir les valeurs ModalResult se référant aux boutons "ALL" en valeurs d'identification correspondant aux boutons simples (Ok, No ou Yes).