クイック・アシスト・プロセッサー

識別子:
org.eclipse.wst.jsdt.ui.quickAssistProcessors

開始:
3.0

説明:
この拡張ポイントによって、クイック・アシスト・プロセッサーを追加して、JavaScript エディターに 新しいクイック・アシストを提供できます。 この拡張ポイントは、enablement タグをサポートしています。テストが実行されるプロパティーは以下のとおりです。
  • compilationUnit: 型は ICompilationUnit。クイック・アシストが適用されるコンパイル単位。
  • projectNatures: 型は Collection。現行プロジェクトのすべてのプロジェクト・ネーチャー。
  • sourceLevel: 型は String。現行プロジェクトのソースの整合性。
  • 構成マークアップ:

    <!ELEMENT extension (quickAssistProcessor+)>

    <!ATTLIST extension

    point CDATA #REQUIRED

    id    CDATA #IMPLIED

    name  CDATA #IMPLIED

    >


    <!ELEMENT quickAssistProcessor (enablement?)>

    <!ATTLIST quickAssistProcessor

    id                  CDATA #REQUIRED

    name                CDATA #IMPLIED

    class               CDATA #IMPLIED

    requiredSourceLevel CDATA #IMPLIED

    >


    <!ELEMENT enablement (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    汎用ルート要素です。 この要素を拡張ポイントの内部で使用すると、enablement 式を定義できます。 enablement 式の子は、「AND」演算子を使用して結合されます。



    <!ELEMENT not (not | and | or | instanceof | test | systemTest | equals | count | with | resolve | adapt | iterate | reference)>

    この要素は、サブ要素式を評価した結果に対する NOT 演算を表します。



    <!ELEMENT and (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    この要素は、サブ要素式すべてを評価した結果に対する AND 演算を表します。



    <!ELEMENT or (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    この要素は、サブ要素式すべてを評価した結果に対する OR 演算を表します。



    <!ELEMENT instanceof EMPTY>

    <!ATTLIST instanceof

    value CDATA #REQUIRED

    >

    この要素は、フォーカスされているオブジェクトの instanceof 検査を実行するために使用されます。 オブジェクトの型が、属性値で指定されている型のサブタイプの場合、この式は EvaluationResult.TRUE を戻します。 これ以外の場合は、EvaluationResult.FALSE を戻します。



    <!ELEMENT test EMPTY>

    <!ATTLIST test

    property              CDATA #REQUIRED

    args                  CDATA #IMPLIED

    value                 CDATA #IMPLIED

    forcePluginActivation (true | false)

    >

    この要素は、フォーカスされているオブジェクトのプロパティー状態を評価するために使用されます。 テスト可能なプロパティーのセットは、org.eclipse.core.expressions.propertyTesters 拡張ポイントを使用して拡張することができます。実際のテストを行う プロパティー・テスターがまだロードされず、属性 forcePluginActivation が false に設定されている場合、 テスト式は EvaluationResult.NOT_LOADED を戻します。 forcePluginActivation が true に設定され、この式の評価に使用される評価コンテキストが プラグインの活動化をサポートしている場合は、プロパティーを評価することで、テスターを定義する プラグインが活動化されます。



    <!ELEMENT systemTest EMPTY>

    <!ATTLIST systemTest

    property CDATA #REQUIRED

    value    CDATA #REQUIRED

    >

    System.getProperty メソッドを呼び出してシステム・プロパティーをテストし、その結果を、 value 属性によって指定された値と比べてください。



    <!ELEMENT equals EMPTY>

    <!ATTLIST equals

    value CDATA #REQUIRED

    >

    この要素は、フォーカスされているオブジェクトの等号検査を実行するために使用されます。 オブジェクトが、属性値によって提供された値と等しい場合、この式は EvaluationResult.TRUE を戻します。 これ以外の場合は、EvaluationResult.FALSE を戻します。



    <!ELEMENT count EMPTY>

    <!ATTLIST count

    value CDATA #REQUIRED

    >

    この要素は、コレクション内の要素の数をテストするために使用されます。



    <!ELEMENT with (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST with

    variable CDATA #REQUIRED

    >

    この要素は、すべての子要素がインスペクション対象であるオブジェクトを、 指定の変数で参照されるオブジェクトに変更します。 変数が解決できない場合、式は、評価時に ExpressionException をスローします。 with 式の子は、「AND」演算子を使用して結合されます。



    <!ELEMENT resolve (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST resolve

    variable CDATA #REQUIRED

    args     CDATA #IMPLIED

    >

    この要素は、すべての子要素がインスペクション対象であるオブジェクトを、 指定の変数で参照されるオブジェクトに変更します。 変数が解決できない場合、式は、評価時に ExpressionException をスローします。 resolve 式の子は、「AND」演算子を使用して結合されます。



    <!ELEMENT adapt (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST adapt

    type CDATA #REQUIRED

    >

    この要素は、フォーカスされているオブジェクトを、属性型で指定されている型に適合させるために使用されます。 アダプターまたは参照される型がまだロードされていない場合、式は「EvaluationResult.NOT_LOADED」を戻します。型名がまったく存在しない場合は、評価中に ExpressionException をスローします。adapt 式の子は、「AND」演算子を使用して結合されます。



    <!ELEMENT iterate (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate , reference)*>

    <!ATTLIST iterate

    operator (or|and)

    ifEmpty  (true | false)

    >

    この要素は、java.util.Collection 型の変数、または org.eclipse.core.expressions.IIterable に適合する変数を繰り返すために使用されます。フォーカスされているオブジェクトの型が上記のいずれかではない場合、式の評価時に ExpressionStatus とともに CoreException がスローされます。iterate 式の子は、「AND」演算子を使用して結合されます。



    <!ELEMENT reference EMPTY>

    <!ATTLIST reference

    definitionId IDREF #REQUIRED

    >

    この要素は、org.eclipse.core.expressions.definitions 拡張ポイントから式を参照する場合に使用します。この式定義は、現行の評価コンテキストを使って現行の式要素内で評価されます。



    例:
    クイック・アシスト・プロセッサーの contribution の例を以下に示します。

    
     <extension point="org.eclipse.wst.jsdt.ui.quickAssistProcessors">
    <quickAssistProcessor
       id="AdvancedQuickAssistProcessor"
       name="Advanced Quick Assist Processor"
       requiredSourceLevel="1.5"  
       class="com.example.AdvancedQuickAssistProcessor">
      </quickAssistProcessor>
       <enablement>
          <with variable="projectNatures">
            <iterate operator="or">
                <equals value="org.eclipse.wst.jsdt.core.javanature"/>
                      </iterate>
                 </with>
               </enablement>
     </extension>
    

    API 情報:
    提供されたクラスは、org.eclipse.wst.jsdt.ui.text.java.IQuickAssistProcessor を実装しなければなりません。


    Copyright (c) 2007 IBM Corporation and others.
    All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html