Direktaufrufe starten

org.eclipse.debug.ui.filaunchShortcuts

Dieser Erweiterungspunkt unterstützt eine auswahlabhängige Aktivierung. Erweiterungen registrieren einen Direktaufruf, der im Untermenüfenster von "Ausführen" und/oder "Debug" angezeigt wird und mit dem die Workbenchauswahl oder der aktive Editor gestartet werden kann.

<!ELEMENT extension (shortcut*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT shortcut (perspective* , contextualLaunch? , enablement?)>

<!ATTLIST shortcut

id            CDATA #REQUIRED

modes         CDATA #REQUIRED

class         CDATA #REQUIRED

label         CDATA #REQUIRED

icon          CDATA #IMPLIED

category      CDATA #IMPLIED

helpContextId CDATA #IMPLIED>


<!ELEMENT perspective EMPTY>

<!ATTLIST perspective

id CDATA #REQUIRED>


<!ELEMENT contextualLaunch (contextLabel* , enablement?)>

Enthält alle Beschreibungen zum Hinzufügen von Direktaufrufen zum Run-Kontextmenü (Pop-up).



<!ELEMENT contextLabel EMPTY>

<!ATTLIST contextLabel

mode  (run|debug|profile)

label CDATA #REQUIRED>

Gibt die Bezeichnung (Label) für einen Kontext-Startmodus an.



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

Ein generisches Stammverzeichniselement. Das Element kann in einem Erweiterungspunkt zum Definieren seines Ausdrucks 'enablement' eingesetzt werden. Die untergeordneten Elemente eines Ausdrucks 'enablement' werden durch den Einsatz des Operators 'and ' kombiniert.



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

Dieses Element stellt eine Operation NOT für das Ergebnis der Auswertung seiner Unterelementausdrücke dar.



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

Dieses Element stellt eine Operation AND für das Auswertungsergebnis aller seiner Unterelementausdrücke dar.



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

Dieses Element stellt eine Operation OR für das Auswertungsergebnis aller seiner Unterelementausdrücke dar.



<!ELEMENT instanceof EMPTY>

<!ATTLIST instanceof

value CDATA #REQUIRED>

Dieses Element wird zur Durchführung einer Prüfung des Typs 'instanceof' für das betrachtete Objekt eingesetzt. Der Ausdruck gibt 'EvaluationResult.TRUE' zurück, wenn der Objekttyp ein Untertyp des Typs ist, der von dem Attributwert angegeben wird. Andernfalls wird 'EvaluationResult.FALSE' zurückgegeben.



<!ELEMENT test EMPTY>

<!ATTLIST test

property CDATA #REQUIRED

args     CDATA #IMPLIED

value    CDATA #IMPLIED>

Dieses Element wird zur Auswertung des Eigenschaftszustands des betrachteten Objekts verwendet. Die Gruppe testbarer Eigenschaften kann durch den Einsatz des Erweiterungspunktes des Eigenschaftstestelements erweitert werden. Der Testausdruck gibt 'EvaluationResult.NOT_LOADED' zurück, wenn der Eigenschafstester, der den aktuellen Test durchführt, noch nicht geladen ist.



<!ELEMENT systemTest EMPTY>

<!ATTLIST systemTest

property CDATA #REQUIRED

value    CDATA #REQUIRED>

Testet eine Systemeigenschaft durch Aufruf der Methode 'System.getProperty' und vergleicht das Ergebnis mit dem Wert, der durch das Wertattribut angegeben wird.



<!ELEMENT equals EMPTY>

<!ATTLIST equals

value CDATA #REQUIRED>

Dieses Element wird zur Durchführung einer Prüfung des Typs 'equals' für das betrachtete Objekt eingesetzt. Der Ausdruck gibt EvaluationResult.TRUE zurüc, wenn das Objekt mit dem Wert übereinstimmt, der von dem Attributwert zur Verfügung gestellt wird. Andernfalls wird 'EvaluationResult.FALSE' zurückgegeben.



<!ELEMENT count EMPTY>

<!ATTLIST count

value CDATA #REQUIRED>

Dieses Element wird zum Testen der Anzahl von Elementen in einer Sammlung verwendet.



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

<!ATTLIST with

variable CDATA #REQUIRED>

Dieses Element ändert das Objekt, das für alle seine untergeordneten Elemente untersucht werden muss, in das Objekt, auf das sich die angegebene Variable bezieht. Wenn die Variable nicht aufgelöst werden kann, dann löst der Ausdruck bei der Auswertung 'ExpressionException' aus. Die untergeordneten Elemente des Ausdrucks 'with' werden durch Verwendung des Operators 'and' kombiniert.



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

<!ATTLIST resolve

variable CDATA #REQUIRED

args     CDATA #IMPLIED>

Dieses Element ändert das Objekt, das für alle seine untergeordneten Elemente untersucht werden muss, in das Objekt, auf das sich die angegebene Variable bezieht. Wenn die Variable nicht aufgelöst werden kann, dann löst der Ausdruck bei der Auswertung 'ExpressionException' aus. Die untergeordneten Elemente des Ausdrucks 'with' werden durch Verwendung des Operators 'and' kombiniert.



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

<!ATTLIST adapt

type CDATA #REQUIRED>

Dieses Element wird zur Anpassung des betrachteten Objektes an den Typ, der durch den Attributtyp angegeben wird, eingesetzt. Der Ausdruck gibt 'not loaded' zurück, wenn entweder der Adapter oder der verwiesene Typ noch nicht geladen ist. Er gibt 'ExpressionException' während der Auswertung aus, wenn der Typname nicht existiert. Untergeordnete Elemente eines Anpassungsausdrucks werden durch Verwendung des Operators 'and' kombiniert.



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

<!ATTLIST iterate

operator (or|and) >

Dieses Element wird zur Iteration einer Variable des Typs 'java.util.Collection' eingesetzt. Wenn das betrachtete Objekt nicht dem Typ 'java.util.Collection' entspricht, wird 'ExpressionException' während der Auswertung des Ausdrucks ausgegeben.



Das folgende Beispiel ist ein Erweiterungspunkt für einen Startdirektaufruf:

 

<extension point=

"org.eclipse.debug.ui.launchShortcuts"

>

<shortcut id=

"com.example.ExampleLaunchShortcutId"

modes=

"run,debug"

class=

"com.example.ExampleLaunchShortcutImpl"

label=

"Example Launch Shortcut"

icon=

"icons/examples.gif"

>

<perspective id=

"org.eclipse.jdt.ui.JavaPerspective"

/>

<perspective id=

"org.eclipse.debug.ui.DebugPerspective"

/>

</shortcut>

</extension>

Im dargestellten Beispiel wird ein Startdirektaufruf in den Lauf- und Debugkaskadenmenüs mit der Kennung "Beispiel für Startdirektaufruf" in derJavaPerspective und der DebugPerspective angezeigt.

Der Wert des Attributs class muss ein vollständig qualifizierte Name einer Java-Klasse sein, die die Schnittstelle org.eclipse.debug.ui.ILaunchShortcut implementiert.