Vcl.StdCtrls.TCustomButton.ModalResult

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property ModalResult: TModalResult read FModalResult write FModalResult default 0;

C++

__property System::Uitypes::TModalResult ModalResult = {read=FModalResult, write=FModalResult, default=0};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Vcl.StdCtrls.pas
Vcl.StdCtrls.hpp
Vcl.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 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.

  • Dans XE = 11
  • Dans XE2 = 8

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.

  • Dans XE = 8
  • Dans XE2 = 12

mrNoToAll

mrAll +1 (13 ou $D)

L'utilisateur est sorti en utilisant le bouton NO TO ALL.

  • Dans XE = 9
  • Dans XE2 = 13

mrYesToAll

mrNoToAll +1 (14 ou $E)

L'utilisateur est sorti en utilisant le bouton YES TO ALL.

  • Dans XE =10
  • Dans XE2 = 14


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.

Voir aussi

Exemples de code