FMX.ActnList.TAction
Delphi
TAction = class(TCustomAction)
C++
class PASCALIMPLEMENTATION TAction : public TCustomAction
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| class | public | FMX.ActnList.pas FMX.ActnList.hpp |
FMX.ActnList | FMX.ActnList |
説明
TAction は、FireMonkey アクション オブジェクトの基底クラスです。 TAction クラスおよびその下位クラスでは、コントロールやメニュー項目やツール ボタンと組み合わせて使用するアクションを実装します。 TAction アクションの published プロパティおよびイベントは、設計時にオブジェクト インスペクタで管理できます。
TAction クラスは、TCustomAction とほぼ同じです。 TAction は、TCustomAction の以下の機能のみ拡張しています。
- AutoCheck、Checked、Enabled、GroupIndex、HelpType、HelpContext、HelpKeyword、Hint、ShortCut、SecondaryShortCuts、Text、Visible、UnsupportedArchitectures、UnsupportedPlatforms のプロパティに対して、public スコープが published に変更。
- OnExecute と OnUpdate イベントに、published スコープを設定。
- これらのプロパティおよびイベントが published スコープになることで、これらのプロパティおよびイベントの値の編集に、オブジェクト インスペクタの使用が可能に。
- アクションの作成中は、DisableIfNoHandler プロパティを True に設定、つまり、OnExecute イベント ハンドラがない場合、アクションにはアクセスできない。
TAction は、汎用アクション コンポーネントです。 これは、ユーザー コマンドに対して希望する応答を実装しているアクション クラスがない場合に、アクション リストへ追加することができます。 定義済みのアクション クラスには、ユーザーがクライアント コントロールをクリックしたときに応答するメソッドが組み込まれているのに対して、TAction には、ユーザー コマンドに対して応答が組み込まれていません。 その代わり、TAction を使用する場合は、（オブジェクト インスペクタを使用して）OnExecute イベントのハンドラを作成することで、アクションが起動したときの応答を指定でき、OnUpdate イベントのハンドラを作成することで、現在の状態を反映するように TAction のプロパティを構成することができます。
アクション オブジェクトは、ユーザー コマンド（アクション）に対する応答の一元化に使用されるほか、アクション リストを使用するアプリケーションでユーザー インターフェイス要素を表すのに使用されます。
Visible プロパティは、アクションの概観を表示するかどうかを定義します。 この Visible 値は、アクションのクライアントで伝播されます。大抵の場合、アクション リンクの IsVisibleLinked は、アクションが TAction に属する場合に True を返します。この場合、アクションの Visible プロパティが False に設定されていると、クライアントの Visible プロパティも False に設定されます。たとえば、クライアントがメニュー項目かコントロールの場合、これらのメニュー項目やコントロールは非表示に設定されます。 TAction における Visible のこの動作は、TCustomViewAction における動作とは反対です。
TAction はまた、定義済みアクションの基底クラスとしても動作します。 サポートされているプロパティおよびイベントを published スコープのままにしておく場合は、TAction からクラスを派生させることができます。 一方、サポートされているプロパティおよびイベントの一部を public スコープにする場合は、TCustomAction からクラスを派生させることができます。
TAction の振る舞いを拡張する定義済みアクションについては、FMX.StdActns ユニット内のアクション クラスを参照してください。