System.Actions.CreateAction

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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());

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Actions.pas
System.Actions.hpp
System.Actions System.Actions


Beschreibung

Erstellt eine Aktion mit dem angegebenen ActionClass-Typ.

Der Aufruf dieser Funktion entspricht im Wesentlichen dem Aufrufen der Methode ActionClass. Der einzige Unterschied besteht darin, dass CreateAction den Parameter Resource der Prozedur RegisterActions zum Initialisieren der Werte des neuen Aktionsobjekts verwendet.

Zum Erstellen einer Aktion ruft die Funktion CreateAction die in der Variable CreateActionProc gespeicherte Prozedur auf. Die IDE muss der Variable CreateActionProc die entsprechende Prozedur zuweisen.

Kurz vor dem Aufrufen der in der CreateActionProc-Variable gespeicherten Prozedur setzt CreateAction die Variable vDesignAction auf True. CreateAction stellt den Anfangswert der Variable vDesignAction wieder her, sobald die Ausführung der Prozedur CreateActionProc abgeschlossen ist. Deshalb kann beim Testen des Wertes der Variable vDesignAction ein Aktionskonstruktor überprüfen, ob sie von der IDE oder einer Benutzeranwendung aufgerufen wurde.

CreateAction hat die folgenden Parameter:

  • AOwner ist der Eigentümer der Aktion. Normalerweise das Formular oder das Datenmodul.
  • ActionClass Legt den Typ der zu erstellenden Aktion fest. Der Typ ist eine Aktionsklasse, die zum Typ TBasicActionClass gehört.
  • FrameworkType muss das GUI-Anwendungs-Framework angeben, in dem die Aktion verwendet werden soll. Dessen Wert muss entweder "VCL" (Standard) oder "FMX" (FireMonkey) sein. Sie können VCL-Aktionen nicht in FireMonkey-Anwendungen verwenden (oder umgekehrt).

Siehe auch