プラグイン

アクションのプロパティ

名前 - アクションの名前。任意の名前を付けることができます。唯一の明らかな制約は、名前がモデルのスコープ内で一意である必要があることです。

ニーモニック - ニーモニックが指定されている場合、このアクションを含むグループが表示されると、alt + ニーモニックショートカットを介してアクションを使用できます。ニーモニック（指定されている場合）は、アクションのキャプションの文字の 1 つである必要があることに注意してください。ニーモニックは、アクションのキャプションに下線付きの記号として表示されます。

必要なアクセス - は、MPS がアクションに提供するアクセス制御を指定します。

• none - アクセス制御は提供されず、最終的なロックはすべてアクションによって手動で実行する必要があります。このアクションは、UI をロックするリスクなしに UI 操作を実行できます。

• 読み取り - 読み取りアクセスが許可されます。このアクションは、UI をロックするリスクなしに UI 操作を実行できます。

• コマンド - MPS モデルのすべての操作はコマンド内で実行されます。コマンドは元に戻すリストの項目であるため (手動で制御するのではなく、MPS が自動的に実行します)、ユーザーはアクションの実行によってモデルに加えられた変更を元に戻すことができます。また、コマンドで実行されるすべてのコードには、モデルへの読み取り / 書き込みアクセス権があります。問題は、コマンド内からユーザーに視覚的なダイアログを表示すると、読み取り / 書き込みロックを保持したままブロックすることでデッドロックが発生する可能性があることです。アクションで UI を使用しない場合にのみ、このオプションを使用することをお勧めします。

• エディターコマンド - 上記のオプションと同様に、アクションは取り消し可能なコマンドのコンテキストで実行され、読み取りおよび書き込みアクセスが許可されます。コマンドはエディターコンテキストから取得されるため、アクションのコンテキストパラメーターの 1 つとしてエディターコンテキストを指定する必要があります。

外部コマンドを実行 - (このオプションは、required access を優先して徐々に放棄する必要があります。true に設定すると、required access プロパティの設定をオーバーライドします) MPS モデルでのすべての操作は、コマンド内で実行されます。コマンドは元に戻すリストの項目であるため (手動で制御するのではなく、MPS が自動的に実行します)、ユーザーはアクションの実行によってモデルに加えられた変更を元に戻すことができます。また、コマンドで実行されるすべてのコードには、モデルへの読み取り / 書き込みアクセス権があります。問題は、コマンド内からユーザーに視覚的なダイアログを表示すると、読み取り / 書き込みロックを保持したままブロックすることでデッドロックが発生する可能性があることです。アクションで UI を使用しない場合にのみ、コマンドの外部実行オプションを false に設定することをお勧めします。それ以外の場合は、true に設定し、読み取りアクションとアクション内のコマンドステートメントを使用して適切な読み取り / 書き込みアクセスロックを手動で実行する必要があります。

でも利用可能 - 現在のところ、これは "everywhere" にしか設定できません。つまり、アクションはコンテキスト内でのみ使用可能になるわけではなく、完了メニューから呼び出すことができますが、他のコンテキストでも呼び出すことができます。例: 何らかのアクションがエディターのコンテキストメニューグループに追加されたが、フォーカスが論理ビュー内にあるとき、すべてのエディターが閉じられたときにそれを利用可能にしたい場合は、"available in" も "everywhere" に設定する必要があります。

キャプション - メニューの動作を表す文字列

説明 - この文字列（指定されている場合）は、このアクションがアクティブなときにステータスバーに表示されます。(任意のメニューで選択)

アイコン - このアイコンは、すべてのメニューのアクションの近くに表示されます。アイコンファイルを選択するか、DSL を使用してアイコンを記述することができます。アイコンファイルは言語の近くに配置する必要があることに注意してください (アイコンファイルはイメージとしてではなく、言語のルートからの相対パスとして保存されるため)。

ビルドパラメーター

各アクションは、構築パラメーターを使用して構築時にパラメーター化できます。これは、アクションの動作を決定する任意のデータです。構成パラメーターを使用する単一のアクションは、複数の異なる動作を表すことができます。アクションを管理しキーマップを処理するために、MPS はアクションによって表されるそれぞれの具体的な振る舞いのためのユニークな識別子を必要とします。そのため、toString 関数が各構築パラメーターに対して導入されました（インスペクタで確認できます）。プリミティブ型の場合、この関数を明示的に指定する必要はありません - MPS は自動的にそれを行うことができます。より複雑なパラメーターの場合は、アクションの具体的な動作ごとに toString() 関数から返される値のセットが異なるように、この関数を明示的に記述する必要があります。

動作制御を有効 / 無効にする

無効な状態でもアクションを表示したい場合（現在のコンテキストでアクションが適用されない場合）は常に見えるフラグ - 、これを true に設定します。それ以外の場合は false に設定します。

コンテキストパラメーター - は、アクションを実行できるようにするために現在のコンテキストにどの項目が存在する必要があるかを指定します。これらは、アクションのメソッドが実行される前にコンテキストから抽出されます。コンテキストパラメーターには、関連付けられた条件があります。required、custom および d id は、最も頻繁に使用される 3 つです。一部の必須パラメーターが抽出されなかった場合、アクション状態は無効に設定され、isApplicable/update/execute メソッドは実行されません。必要なアクションパラメーターがすべて抽出されている場合は、その値をすべてのアクションメソッドで使用できます。カスタムコンテキストパラメーターでは、提供された関数を使用して、コンテキストパラメーターが必須かどうかをケースバイケースで決定するオプションが提供されます。is 条件は、取得したオブジェクトを指定されたクラスに対してテストします。

アクションパラメーターには、単純アクションパラメーターと複雑アクションパラメーターの 2 種類があります。

• シンプルなアクションパラメーター (ActionDataParameterDeclaration で表されます) を使用すると、現在のデータコンテキストから利用可能なすべてのデータを簡単に抽出できます。データは「キーによって」提供されるため、宣言で名前とキーを指定する必要があります。パラメーターの型は自動的に設定されます。

• 複雑なアクションパラメーター（ActionParameterDeclaration で表される）が導入され、頻繁に使用されるチェックと型キャストが実行されました。現在、この型のコンテキストパラメーターに使用できる型は 3 つあります。

  • 指定された概念のインスタンスで現在選択されているノード、- ノード <概念>。選択したノードがこの概念のインスタンスでない場合、アクションは有効になりません。

  • nlist <概念> - 現在選択されたノード。すべてのノードがコンセプトのインスタンスであることがチェックされます（指定されている場合）。ノード <概念> と同様に、チェックが失敗した場合、アクションは有効になりません。

  • モデル - 現在のモデルが選択されたノードを保持しています

該当 / 更新あり - このメソッドは、コンテキストパラメーターと連携して、アクションの有効 / 無効状態を制御します。次の 2 つのオプションのいずれかを選択できます。

• isApplicable メソッドはアクションの新しい状態を返します

• update メソッドは、状態を手動で更新するように設計されています。event.getPresentation() を介してアクションのプレゼンテーションにアクセスすることにより、アクションのプロパティ（キャプション、アイコンなど）を更新することもできます。アクションで setEnabledState() メソッドを呼び出して、手動で有効または無効にします。

これらのメソッドは、必要なすべてのコンテキストパラメーターがコンテキストから正常に抽出された場合にのみ実行されます。

注: このキーワードは現在のアクションを参照します。action<...> を使用して、コードから表示されているアクションを取得します。

実行 - このメソッドは、アクションが実行されるときに実行されます。同じイベントに対するアクションの更新メソッドがアクションをアクティブ状態のままにし（または isApplicable が true を返した）、必要なすべてのコンテキストパラメーターが現在のコンテキストに存在し、入力された場合にのみ実行されることが保証されます。

メソッド - このセクションでは、ユーティリティメソッドを宣言できます。

グループ構成

グループは一連のアクションを記述し、他のグループを現在のグループで変更する方法に関する情報を提供します。

表現

お名前 - グループの名前。好きな名前を付けることができます。唯一の明らかな制約は、名前がモデルの範囲内で一意でなければならないことです。

これが当てはまる場合、ポップアップです - はポップアップメニューを表し、そうでない場合はアクションのリストを表します。

「is popup」が正しい場合

• ポップアップメニューの名前として表示されるキャプション - 文字列

• ニーモニック - ニーモニックが指定されている場合、ポップアップメニューは、それを含むグループが表示されたときに、alt + ニーモニックショートカットを介して使用できます。 ニーモニック（指定されている場合）は、caption の文字の 1 つでなければならないことに注意してください。ニーモニックは、ポップアップメニューのキャプションに下線付きの記号として表示されます。

• 無効にすると見えなくなります - が true に設定されている場合、有効なアクションがないか、update() メソッドで手動で無効にされている場合、グループは表示されません。アクショングループで enable()/disable() メソッドを呼び出して、手動で有効または無効にします。

内容

グループの内容を説明する 3 つの可能性があります。

要素リスト - これは、アクション、グループ、ラベルの単なる静的リストです（変更を参照）。利用可能な要素は以下のとおりです。

• -> 名前 - アンカー。アンカーは、あるグループを別のグループで変更するために使用されます。詳細については、「ステートメントを追加」セクションを参照してください。

• <---> - セパレーター

• ActionName[parameters] - アクション

ビルド - この選択肢はグループで使用されるべきで、その内容は静的ですが、いくつかの初期条件に依存します - グループは一度構築され、それ以降は更新されません。ビルドブロック内に要素を追加するには、add ステートメントを使用します。

更新 - これは動的に変化するグループに適用されます。グループはレンダリングされる直前に毎回更新されます。

修正とラベル

位置 <位置> で <グループ> に追加 - このステートメントは、現在のグループを指定された位置の <group> に追加します。すべてのグループには <default> 位置があり、現在のグループをターゲットグループの最後に追加するように指示します。一部のグループは、いわゆるアンカーを自分たちに追加することで、追加の位置を提供できます。アンカーの追加については、コンテンツセクションで説明しています。アンカー自体は非表示であり、グループを挿入できる位置を表します。

actionGroup <...> 式

登録されたグループにアクセスするために jetbrains.mps.lang.plugin 言語で使用できる特定の式（actionGroup < グループ > 式）があります。

IdeaComponent.xml

IntelliJ プラットフォームの要求に応じて、生成されたコンポーネント .xml ファイルを通じて、グループ、ブートストラップグループ、およびキーマップを静的に登録します。

Bootstrap グループ

Bootstrap グループは、MPS の外部で定義されたアクショングループ（たとえば、IDEA または一部の IDEA プラグインによって提供されたグループ）を操作する方法です。

この場合、ブートストラップグループは MPS で定義され、その内部 ID は外部グループの ID に設定されます。これを行った後、通常のブートストラップグループと同じようにブートストラップグループを操作できます。グループに挿入したり、その逆を行ったりできます。

通常のユーザーがブートストラップグループを使用する必要はめったにありません。

インスペクターの plugin.xml オプションによる登録は、通常のグループの場合と同じ意味を持ち、上で説明されています。