System.Actions.CreateActionProc

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

CreateActionProc: function(AOwner: TComponent;
ActionClass: TBasicActionClass;
const FrameworkType: string): TBasicAction = nil;

C++

extern DELPHI_PACKAGE System::Classes::TBasicAction* __fastcall (*CreateActionProc)(System::Classes::TComponent* AOwner, System::Classes::TBasicActionClass ActionClass, const System::UnicodeString FrameworkType);

Propriétés

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

Description

La variable procédurale globale qui stocke une procédure ayant pour effet de créer des actions.

La variable procédurale CreateActionProc est appelée depuis la fonction CreateAction.

CreateAction est appelée automatiquement lorsque vous ajoutez une action à une liste d'actions (dans l'éditeur de liste d'actions) ou à une bande d'actions (dans le Gestionnaire d'actions -- uniquement disponible pour la VCL) lors de la conception dans l'EDI. Par conséquent, l'EDI doit assigner la procédure adéquate à la variable CreateActionProc.

L'appel de cette procédure doit effectuer la même opération que l'appel de ActionClass.Create (Delphi) ou du constructeur de la classe d'actions ActionClass spécifiée (C++). Toutefois, dans la mesure où cette procédure est appelée depuis l'EDI, à partir de l'éditeur de liste d'actions), ou depuis le Gestionnaire d'actions, elle peut utiliser le paramètre Resource de la procédure RegisterActions pour initialiser les valeurs du nouvel objet action.

La variable procédurale CreateActionProc comporte les paramètres suivants :

Paramètre Description
ActionClass

Définit le type de l'action à créer. Le type est une classe d'actions appartenant au type TBasicActionClass.

Lorsque CreateAction est appelée depuis l'éditeur de liste d'actions de l'EDI ou depuis le Gestionnaire d'actions, ActionClass est l'une des classes d'actions standard enregistrées.

AOwner

Le propriétaire de l'action. C'est habituellement la fiche ou le module de données.

FrameworkType

Définti si une action doit être créée pour la VCL ou le framework FireMonkey (FMX).

Ce paramètre permet d'éviter certaines situations dans lesquelles les actions VCL sont utilisées dans des applications FireMonkey et vice versa. Cela peut conduire à une taille d'application augmentant sérieusement et à des erreurs d'exécution, par exemple l'appel de l'API Windows sous MacOS.

La valeur par défaut est nil (Delphi) ou NULL (C++).

Voir aussi