System.Actions.CreateAction
Delphi
function CreateAction(AOwner: TComponent; ActionClass: TBasicActionClass; FrameworkType: string = ''): TBasicAction;
C++
extern DELPHI_PACKAGE System::Classes::TBasicAction* __fastcall CreateAction(System::Classes::TComponent* AOwner, System::Classes::TBasicActionClass ActionClass, System::UnicodeString FrameworkType = System::UnicodeString());
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Actions.pas System.Actions.hpp |
System.Actions | System.Actions |
Description
Crée une action du type ActionClass spécifié.
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.
L'appel de cette fonction a le même effet que l'appel de ActionClass.Create (Delphi) ou du constructeur de la classe d'actions ActionClass spécifiée (C++). La seule exception est que CreateAction utilise le paramètre Resource de la procédure RegisterActions pour initialiser les valeurs du nouvel objet action.
Pour créer une action, la fonction CreateAction appelle la procédure stockée dans la variable CreateActionProc. L'EDI doit assigner la procédure adéquate à la variable CreateActionProc.
Avant d'appeler la procédure stockée dans la variable CreateActionProc, CreateAction définit la variable vDesignAction sur True. CreateAction restaure la valeur initiale de la variable vDesignAction dès que l'exécution de la procédure CreateActionProc a eu lieu. En conséquence, lors du test de la valeur de la variable vDesignAction, un constructeur d'action peut vérifier si elle est appelée depuis l'EDI ou depuis une application utilisateur.
CreateAction 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, |
AOwner
|
Le propriétaire de l'action. C'est habituellement la fiche ou le module de données. |
FrameworkType
|
Définit si une action doit être créée pour la VCL ou le framework FireMonkey (FMX). La valeur par défaut (ou 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. |