Vcl.StdCtrls.TButton.ModalResult
Delphi
property ModalResult: TModalResult read FModalResult write FModalResult default 0;
C++
__property ModalResult = {default=0};
Sommaire
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
property | published | Vcl.StdCtrls.pas Vcl.StdCtrls.hpp |
Vcl.StdCtrls | TButton |
Description
Détermine si le choix de ce bouton ferme sa fiche parent (modale) et comment cette fermeture a lieu.
Vcl.StdCtrls.TButton.ModalResult hérite de Vcl.StdCtrls.TCustomButton.ModalResult. Tout le contenu en-dessous de cette ligne se réfère à Vcl.StdCtrls.TCustomButton.ModalResult.
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 composant bouton est un moyen aisé pour faire en sorte qu'un clic sur le bouton provoque la fermeture d'une fiche modale. 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 du bouton.
Si, par exemple, une boîte de dialogue possède des boutons OK et Annuler, leurs propriétés ModalResult peuvent être respectivement définies sur mrOk et mrCancel lors de la conception. Lors de l'exécution, un clic sur le bouton OK modifie la valeur de la propriété ModalResult de la boîte de dialogue et lui affecte la valeur mrOk ; un clic sur le bouton Annuler lui affecte la valeur mrCancel. Si aucun autre traitement n'est requis, aucun gestionnaire d'événement OnClick n'est requis pour les boutons.
Modifications relatives aux valeurs ModalResult pour XE2
La version XE2 a introduit trois nouvelles valeurs pour ModalResult : mrContinue, mrHelp et mrTryAgain.
De plus, quatre des valeurs ModalResult existantes ont été modifiées pour XE2. Si vos applications utilisent l'une quelconque des quatre valeurs de ModalResult pour TButton, vous devez effectuer les modifications de code suivantes : mrClose, mrAll, mrNoToAll et mrYesToAll. Comme ces valeurs sont stockées sous forme de nombres dans les fichiers .dfm, les valeurs changent lorsque vous migrez un projet vers XE2. Les valeurs ont été modifiées comme suit :
- Avant XE2 :
- mrClose=11
- mrAll=8
- mrNoToAll=9
- mrYesToAll=10
- Dans XE2 :
- mrClose=8
- mrAll=12
- mrNoToAll=13
- mrYesToAll=14
Le tableau suivant liste les constantes de type TModalResult qui sont définies pour la propriété ModalResult ainsi que leurs valeurs dans la release XE2 et dans la release XE (c'est-à-dire les releases antérieures à XE2) :
Constante | Valeur | Signification | Releases prises en charge |
---|---|---|---|
mrNone |
0 |
Aucune. Utilisée comme valeur par défaut avant la sortie de l'utilisateur. |
Toutes les releases |
mrOk |
idOK = 1 |
L'utilisateur est sorti en utilisant le bouton OK. |
Toutes les releases |
mrCancel |
idCancel = 2 |
L'utilisateur est sorti en utilisant le bouton CANCEL. |
Toutes les releases |
mrAbort |
idAbort = 3 |
L'utilisateur est sorti en utilisant le bouton ABORT. |
Toutes les releases |
mrRetry |
idRetry = 4 |
L'utilisateur est sorti en utilisant le bouton RETRY. |
Toutes les releases |
mrIgnore |
idIgnore = 5 |
L'utilisateur est sorti en utilisant le bouton IGNORE. |
Toutes les releases |
mrYes |
idYes = 6 |
L'utilisateur est sorti en utilisant le bouton YES. |
Toutes les releases |
mrNo |
idNo = 7 |
L'utilisateur est sorti en utilisant le bouton NO. |
Toutes les releases |
mrClose |
idClose = 8 |
L'utilisateur est sorti en utilisant le bouton CLOSE. |
|
mrHelp |
idHelp = 9 |
L'utilisateur est sorti en utilisant le bouton HELP. |
Nouveautés dans XE2 |
mrTryAgain |
idTryAgain = 10 |
L'utilisateur est sorti en utilisant le bouton TRY AGAIN. |
Nouveautés dans XE2 |
mrContinue |
idContinue = 11 |
L'utilisateur est sorti en utilisant le bouton CONTINUE. |
Nouveautés dans XE2 |
mrAll |
mrContinue + 1 (12 ou $C) |
L'utilisateur est sorti en utilisant le bouton ALL. |
|
mrNoToAll |
mrAll +1 (13 ou $D) |
L'utilisateur est sorti en utilisant le bouton NO TO ALL. |
|
mrYesToAll |
mrNoToAll +1 (14 ou $E) |
L'utilisateur est sorti en utilisant le bouton YES TO ALL. |
|
Pour des informations détaillées et des solutions, voir la section "XE2 values of mrAll, mrNoToAll, mrYesToAll and mrClose" de l'article http://www.bobswart.nl/Weblog/Blog.aspx?RootId=5:5029.