INVOKE ACTION

4D v19

INVOKE ACTION


INVOKE ACTION ( action {; target} )

引数	型	説明
action	文字	標準アクション名、あるいは(必要であれば)引数を含めたパターン
target	倍長整数	アクションを実行する場所を定義: カレントフォーム(デフォルト)あるいはメインフォーム

INVOKE ACTIONコマンドはaction 引数で定義された標準アクションを、任意のtarget 引数で指定したコンテキストでトリガーします。

action 引数には、実行したい標準アクションの名前を渡します。文字列、あるいは標準アクションテーマの定数を渡すことができます。

使用できる全ての標準アクションは、4Dデザインリファレンスマニュアルの標準アクションの章にまとめてあります。

注:

一部のアクションでは引数を受け取ることができます。この場合、次のパターンに従わなければなりません: actionName?parameterName=parameterValue
例: "gotoPage?value=2"
4D Write Proドキュメント用の特定のアクションが追加で提供されています。これらの詳細については4D Write Proリファレンスマニュアルの4D Write Pro標準アクションの使用の章にまとめてあります。

target 引数には、action 引数で指定したアクションを実行したいフォームコンテキストを渡すことができます。標準アクションテーマの以下の定数のうちどれか一つを使用することができます:

定数	型	値	コメント
ak current form	倍長整数	1	カレントフォームはこのアクションが呼び出されたフォームです。メインフォーム、あるいはカレントプロセスのメインフォームの前面にあるパレットフォームのどちらかです。
ak main form	倍長整数	2	メインフォームとは最前面のドキュメントあるいはプロセスのダイアログフォームであり、フロートウィンドウやポップアップウィンドウなどは除きます。

注: target 引数が省略された場合、デフォルトでak current form コンテキストが使用されます。

target 引数によって、INVOKE ACTIONコマンドの実行は同期あるいは非同期で行われます:

target 引数にak current form を渡した場合、INVOKE ACTION コマンドは同期で行われます。つまりそのアクションはカレントサイクルにおいてコマンドが呼び出された瞬間に実行されます。
target 引数にak main form を渡した場合、INVOKE ACTION コマンドは非同期で行われます。つまりそのアクションはフォームオブジェクトの実行が完了した後に次のサイクルにおいて実行されます。

注: 標準の編集アクション(カット、コピー、ペースト、すべてを選択、削除、取り消す/やり直す)はtarget 引数を渡された場合、無視します。これらのアクションは常に、フォーカスが入っている編集可能オブジェクトコンテキストにおいて同期で実行されるからです。

INVOKE ACTION コマンドはエラーを生成しません。例えば、指定したアクションがカレントのコンテキストでは利用不可能な場合などにおいてもエラーは生成されません。Get action info コマンドを使用して、予定しているアクションを評価する必要があります。

カレントフォームにおいてコピーの標準アクションを実行したい場合を考えます:

INVOKE ACTION(ak copy;ak current form)

メインフォームにおいて指定したページへ移動標準アクション(3ページ)を実行したい場合を考えます:

INVOKE ACTION(ak goto page+"?value=3";ak main form)

参照