System.Actions.TContainedAction.DisableIfNoHandler

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property DisableIfNoHandler: Boolean read FDisableIfNoHandler write FDisableIfNoHandler  default True;

C++

__property bool DisableIfNoHandler = {read=FDisableIfNoHandler, write=FDisableIfNoHandler, default=1};

Propriétés

Type Visibilité  Source Unité  Parent
property public
System.Actions.pas
System.Actions.hpp
System.Actions TContainedAction


Description

Indique si les clients de l'action doivent être désactivés si aucun gestionnaire d’événements OnExecute n'est trouvé.

DisableIfNoHandler indique s'il faut définir la propriété Enabled de l'action sur False au cas ou aucun gestionnaire d'événement OnExecute n'est défini pour l'action. La définition de Enabled sur False désactive tous les clients de l'action.

Voyez, par exemple, comment FMX.Forms.TApplication.UpdateAction utilise DisableIfNoHandler pour établir s'il faut définir Enabled sur False si le gestionnaire d'événement OnExecute n'est pas assigné à l'action.

Par exemple, la définition de DisableIfNoHandler sur False peut être utile lors de la gestion des sous-menus. Dans ce cas, pointant sur une commande du menu principal, qui détermine l'ouverture du sous-menu, ne nécessite aucun gestionnaire d'événement OnExecute. Puis, si DisableIfNoHandler vaut True, cette commande de menu principal est désactivée et le sous-menu ne peut pas être ouvert. Dans de tels cas, il peut être commode d'utiliser des actions des types FMX.Controls.TControlAction et Vcl.Controls.TControlAction. Les objets de ces classes ont leur propriété DisableIfNoHandler définie sur la valeur False par défaut.

Voir aussi