API:Vcl.AppEvnts.TApplicationEvents.OnActionUpdate

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property OnActionUpdate: TActionEvent read FOnActionUpdate write FOnActionUpdate;

C++

__property OnActionUpdate;

Propriétés

Type Visibilité  Source Unité  Parent
event published
Vcl.AppEvnts.pas
Vcl.AppEvnts.hpp
Vcl.AppEvnts TApplicationEvents

Description

Se produit quand la méthode Update d'une action est appelée si la liste d'actions ne la gère pas.

Vcl.AppEvnts.TApplicationEvents.OnActionUpdate hérite de Vcl.AppEvnts.TCustomApplicationEvents.OnActionUpdate. Tout le contenu en-dessous de cette ligne se réfère à Vcl.AppEvnts.TCustomApplicationEvents.OnActionUpdate.

Se produit quand la méthode Update d'une action est appelée si la liste d'actions ne la gère pas.

Utilisez les gestionnaires d'événements OnActionUpdate pour mettre à jour les propriétés d'une action lorsqu'une application est inoccupée si l'action n'est pas gérée dans un gestionnaire OnUpdate par la liste d'actions de cette action. OnActionUpdate se produit après l'événement OnIdle.

Si la liste d'actions contenant l'action ne la met pas à jour dans un gestionnaire d'événement OnUpdate, l'action est redirigée sur l'événement OnActionUpdate de l'objet Application. L'objet événement d'application se raccorde à cet événement et y répond avec son propre gestionnaire d'événement OnActionUpdate.

Le gestionnaire d'événement a un paramètre Handled qui renvoie false par défaut. Si le gestionnaire est défini et gère l'événement, il doit renvoyer true pour terminer la séquence de traitement. Si le gestionnaire d'événement est défini et que Handled est initialisé à false, l'événement va vers les objets événements d'applications, puis l'événement OnUpdate de l'action se produit. Si l'action reste non gérée après cela, la méthode UpdateAction du contrôle actif est appelée pour permettre à l'action de s'exécuter avec une cible identifiée. Enfin, la méthode UpdateAction de la fiche active est appelée si tous les autres gestionnaires ne gèrent pas l'action.

Remarque :  Appelez la méthode CancelDispatch à partir d'un gestionnaire d'événement OnActionUpdate pour éviter que l'application n'envoie l'événement à n'importe quel autre objet d'événements d'application.

Voir aussi