プラグイン

アクションのプロパティ

名前 - アクションの名前。名前はモデルのスコープ内で一意である必要があり、大文字小文字の区別が適切かどうかがチェックされます（名前の適切な大文字表記を参照）。

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

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

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

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

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

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

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

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

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

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

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

ビルドパラメーター

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

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

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

コンテキストパラメーター - は、アクションを実行するために現在のコンテキストに存在する必要がある項目を指定します。これらは、アクションのメソッドが実行される前にコンテキストから抽出されます。コンテキストパラメーターには条件が関連付けられており、required、custom、id が最もよく使用される 3 つの条件です。必須パラメーターの一部が抽出されなかった場合、アクションの状態は disabled に設定され、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 オプションによる登録は、通常のグループの場合と同じ意味を持ち、上で説明されています。