System.Actions.CreateAction

提供:RAD Studio API Documentation

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

プロパティ

種類 可視性 ソース ユニット 親
function public
System.Actions.pas
System.Actions.hpp
System.Actions System.Actions


説明

指定された ActionClass 型のアクションを作成します。

この関数の呼び出しは、ActionClass のコンストラクタの呼び出しと同じ効果があります。 唯一違うのは、CreateAction は RegisterActions プロシージャの Resource パラメータを使用してい、新しいアクション オブジェクトの値を初期化する点です。

アクションを作成するには、CreateAction 関数は、CreateActionProc 変数に格納されているプロシージャを呼び出します。 IDE は、適切な手続きを、CreateActionProc 変数に割り当てます。

CreateActionProc 変数に格納されているプロシージャを呼び出す直前に、CreateAction はvDesignAction 変数を True に設定します。 CreateAction は、vDesignAction 変数の初期値を、CreateActionProc プロシージャの実行が完了するとすぐに復元します。 そのため、アクションのコンストラクタで vDesignAction 変数の値を確認すると、コンストラクタが IDE から呼び出されたのかユーザー アプリケーションから呼び出されたのかを知ることができます。

CreateAction には、次のパラメータがあります:

  • AOwner は、アクションの所有者です。 通常は、フォームまたはデータ モジュールです。
  • ActionClass は、作成するアクションの型を指定します。 型は、TBasicActionClass 型に属するアクション クラスです。
  • FrameworkType は、アクションを使用したい GUI アプリケーション フレームワークを指定しなければなりません。その値は、VCL"(デフォルト)または "FMX"(FireMonkey)でなければなりません。 VCL アクションを FireMonkey アプリケーションで使用することはできず、またその逆もしかりです。

関連項目