Skróty uruchamiania

org.eclipse.debug.ui.launchShortcuts

Ten punkt rozszerzenia udostępnia obsługę uruchamiania kontekstowego. Rozszerzenia rejestrują skrót, który jest wyświetlany w menu kaskadowych wykonywania i/lub debugowania i umożliwia uruchamianie elementów wybranych w środowisku roboczym lub aktywnym edytorze.

<!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

path          CDATA #IMPLIED>


<!ELEMENT perspective EMPTY>

<!ATTLIST perspective

id CDATA #REQUIRED>

Element perspective jest nieaktualny od wersji 3.1. Menu kaskadowe najwyższego poziomu Wykonaj/Debuguj/Profiluj teraz obsługują uruchamianie kontekstowe (zależne od wyboru) i klienci powinni w zamian udostępniać element contextualLaunch.



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

Przechowuje wszystkie opisy służące do dodawania skrótów do kontekstowych menu kaskadowych Wykonaj/Debuguj/Profiluj.



<!ELEMENT contextLabel EMPTY>

<!ATTLIST contextLabel

mode  (run|debug|profile)

label CDATA #REQUIRED>

Określa etykietę dla trybu uruchamiania kontekstowego.



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

Ogólny element główny. Element ten może być stosowany w ramach punktu rozszerzenia do zdefiniowania jego wyrażenia włączającego. Elementy potomne wyrażenia włączającego łączy się za pomocą operatora and.



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

Element ten odpowiada operacji NOT wykonywanej na wynikach oceny wyrażenia podelementu.



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

Element ten odpowiada operacji AND wykonywanej na wynikach oceny wszystkich wyrażeń podelementów.



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

Element ten odpowiada operacji OR wykonywanej na wynikach oceny wszystkich wyrażeń podelementów.



<!ELEMENT instanceof EMPTY>

<!ATTLIST instanceof

value CDATA #REQUIRED>

Element ten służy do wykonywania sprawdzenia instanceof obiektu aktywnego. Wyrażenie zwraca wartość EvaluationResult.TRUE, jeśli typ obiektu jest podtypem typu określonego atrybutem value. W przeciwnym razie zwracana jest wartość EvaluationResult.FALSE.



<!ELEMENT test EMPTY>

<!ATTLIST test

property CDATA #REQUIRED

args     CDATA #IMPLIED

value    CDATA #IMPLIED>

Element ten służy do oceny stanu właściwości obiektu aktywnego. Zbiór właściwości objętych testowaniem można rozszerzyć za pomocą punktu rozszerzenia testera właściwości. Wyrażenie testowe zwraca wartość EvaluationResult.NOT_LOADED, jeśli nie załadowano jeszcze testera właściwości wykonującego faktyczne testowanie.



<!ELEMENT systemTest EMPTY>

<!ATTLIST systemTest

property CDATA #REQUIRED

value    CDATA #REQUIRED>

Testuje właściwość systemową, wywołując metodę System.getProperty i porównując wynik z wartością określoną za pomocą atrybutu value.



<!ELEMENT equals EMPTY>

<!ATTLIST equals

value CDATA #REQUIRED>

Element ten służy do wykonywania sprawdzenia equals obiektu aktywnego. Wyrażenie zwraca wartość EvaluationResult.TRUE, jeśli obiekt jest równy wartości określonej atrybutem value. W przeciwnym razie zwracana jest wartość EvaluationResult.FALSE.



<!ELEMENT count EMPTY>

<!ATTLIST count

value CDATA #REQUIRED>

Element ten służy do sprawdzania liczby elementów w ramach kolekcji.



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

<!ATTLIST with

variable CDATA #REQUIRED>

Element ten zamienia obiekt, który ma być sprawdzany w odniesieniu do wszystkich elementów potomnych, na obiekt, do którego odnosi się dana zmienna. Jeśli zmiennej nie można zinterpretować, podczas oceny wyrażenie zgłasza wyjątek ExpressionException. Elementy potomne wyrażenia with łączy się za pomocą operatora and.



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

<!ATTLIST resolve

variable CDATA #REQUIRED

args     CDATA #IMPLIED>

Element ten zamienia obiekt, który ma być sprawdzany w odniesieniu do wszystkich elementów potomnych, na obiekt, do którego odnosi się dana zmienna. Jeśli zmiennej nie można przetłumaczyć, podczas oceny wyrażenie zgłasza wyjątek ExpressionException. Elementy potomne wyrażenia with łączy się za pomocą operatora and.



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

<!ATTLIST adapt

type CDATA #REQUIRED>

Element ten służy do dostosowywania obiektu aktywnego do typu określonego atrybutem type. Wyrażenie zwraca wartość not loaded, jeśli nie załadowano jeszcze adaptera lub typu, którego dotyczy odwołanie. Jeśli nazwa typu nie istnieje, podczas oceny zgłaszany jest wyjątek ExpressionException. Elementy potomne wyrażenia adapt łączy się za pomocą operatora and.



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

<!ATTLIST iterate

operator (or|and) >

Element ten służy do iteracji zmiennej typu java.util.Collection. Jeśli obiekt aktywny nie jest obiektem typu java.util.Collection, podczas oceny wyrażenia zgłaszany jest wyjątek ExpressionException.



Poniżej przedstawiono przykład punktu rozszerzenia skrótu uruchamiania:

 

<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>

W powyższym przykładzie w perspektywach JavaPerspective i DebugPerspective w menu kaskadowych wykonywania i debugowania będzie wyświetlany skrót uruchamiania z etykietą "Example Launch Shortcut".

Wartość atrybutu class musi być pełną nazwą klasy Java implementującej interfejs org.eclipse.debug.ui.ILaunchShortcut.

Od wersji 3.1 platforma debugowania rejestruje procedury obsługi poleceń dla każdego skrótu uruchamiania i dostępne tryby, aby umożliwić klientom definiowanie przypisań klawiszy dla każdego skrótu uruchamiania. Identyfikator komendy dla procedury uruchamiania jest generowany jak atrybut identyfikatora skrótu uruchamiania - kończy się kropką i nazwą odpowiedniego trybu uruchamiania. Na przykład identyfikator komendy w powyższym przykładzie skrótu uruchamiania podczas uruchamiania w trybie debugowania będzie miał postać com.example.ExampleLaunchShortcutId.debug. Aby przypisać kombinację klawiszy "ALT-SHIFT-D, E" do skrótu uruchamiania, komenda i przypisania klawiszy mogą zostać zdefiniowane w sposób przedstawiony w poniższym przykładzie:

   

<extension point=

"org.eclipse.ui.commands"

>

<command name=

"Debug Example Launch"

description=

"Debug Example Launch"

categoryId=

"org.eclipse.debug.ui.category.run"

id=

"com.example.ExampleLaunchShortcutId.debug"

>

</command>

<keyBinding keySequence=

"M3+M2+D E"

contextId=

"org.eclipse.ui.globalScope"

commandId=

"com.example.ExampleLaunchShortcutId.debug"

keyConfigurationId=

"org.eclipse.ui.defaultAcceleratorConfiguration"

>

</keyBinding>

</extension>