Atalhos de Ativação

org.eclipse.debug.ui.launchShortcuts

Este ponto de extensão fornece suporte para ativação sensível à seleção. As extensões registram um atalho que aparece nos menus em cascata executar e/ou depurar para ativar a seleção do workbench ou do editor ativo.

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

O elemento perspective foi desaprovado no release 3.1. Os menus em cascata de Execução/Depuração/Perfil de nível superior suportam agora ativação contextual (relacionada à seleção) e os clientes devem fornecer um elemento contextualLaunch em vez disso.



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

Mantém todas as descrições de inclusão de atalhos relacionados à seleção dos menus de Execução/Depuração/Perfil em cascata.



<!ELEMENT contextLabel EMPTY>

<!ATTLIST contextLabel

mode  (run|debug|profile)

label CDATA #REQUIRED>

Especifica a etiqueta para o modo de ativação contextual.



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

Um elemento de raiz genérico. O elemento pode ser utilizado dentro de um ponto de extensão para definir sua expressão de ativação. Os filhos de uma expressão de ativação são combinados utilizando o operador and.



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

Este elemento representa uma operação NOT como resultado da avaliação de sua expressão do subelemento.



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

Este elemento representa uma operação AND como resultado da avaliação de todas as suas expressões de subelemento.



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

Este elemento representa uma operação OR como resultado da avaliação de todas as suas expressões de subelemento.



<!ELEMENT instanceof EMPTY>

<!ATTLIST instanceof

value CDATA #REQUIRED>

Este elemento é utilizado para executar uma instância de verificação do objeto em foco. A expressão retorna EvaluationResult.TRUE se o tipo do objeto é um sub-tipo do tipo especificado pelo valor do atributo. Caso contrário, EvaluationResult.FALSE é retornado.



<!ELEMENT test EMPTY>

<!ATTLIST test

property CDATA #REQUIRED

args     CDATA #IMPLIED

value    CDATA #IMPLIED>

Esse elemento é utilizado para avaliar o estado da propriedade do objeto em foco. O conjunto de propriedades testáveis pode ser estendido utilizando o ponto de extensão do testador adequado. A expressão de teste retorna EvaluationResult.NOT_LOADED se o testador de propriedade, que está fazendo o teste real, ainda não foi carregado.



<!ELEMENT systemTest EMPTY>

<!ATTLIST systemTest

property CDATA #REQUIRED

value    CDATA #REQUIRED>

Testa uma propriedade do sistema chamando o método System.getProperty e compara o resultado com o valor especificado pelo atributo value.



<!ELEMENT equals EMPTY>

<!ATTLIST equals

value CDATA #REQUIRED>

Esse elemento é utilizado para executar uma verificação equals do objeto em foco. A expressão retorna EvaluationResult.TRUE se o objeto for igual ao valor fornecido pelo valor do atributo. Caso contrário, EvaluationResult.FALSE é retornado.



<!ELEMENT count EMPTY>

<!ATTLIST count

value CDATA #REQUIRED>

Este elemento é utilizado para testar o número de elementos em uma coleta.



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

<!ATTLIST with

variable CDATA #REQUIRED>

O elemento altera o objeto, a ser inspecionado para todos os seus elementos filho, para o objeto referenciado pela variável fornecida. Se a variável não pode ser solucionada, então a expressão irá lançar um ExpressionException ao avaliá-la. Os filhos de uma expressão com são combinados utilizando o operador and.



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

<!ATTLIST resolve

variable CDATA #REQUIRED

args     CDATA #IMPLIED>

O elemento altera o objeto, a ser inspecionado para todos os seus elementos filho, para o objeto referenciado pela variável fornecida. Se a variável não pode ser solucionada, então a expressão irá lançar um ExpressionException ao avaliá-la. Os filhos de uma expressão com são combinados utilizando o operador and.



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

<!ATTLIST adapt

type CDATA #REQUIRED>

Este elemento é utilizado para adaptar o objeto em foco ao tipo especificado pelo tipo de atributo. A expressão retorna sem estar carregada se o adaptador ou o tipo referenciado ainda não estiver carregado. Isso lança um ExpressionException durante a avaliação se o nome do tipo não existir. Os filhos de uma expressão de adaptação são combinados utilizando o operador and.



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

<!ATTLIST iterate

operator (or|and) >

Esse elemento é utilizado para repetir uma variável do tipo java.util.Collection. Se o objeto em foco não é do tipo java.util.Collection, então, um ExpressionException será lançado ao avaliar a expressão.



A seguir encontra-se um exemplo de um ponto de extensão de atalho de lançamento:

 

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

No exemplo acima, um atalho de lançamento será mostrado nos menus em cascata executar e depurar com o rótulo "Atalho de Lançamento de Exemplo", no JavaPerspective e DebugPerspective.

O valor do atributo class deve ser um nome completo de uma classe Java que implementa a interface org.eclipse.debug.ui.ILaunchShortcut.

Desde o 3.1, a plataforma de depuração registra uma rotina de tratamento de comando para cada atalho de ativação e seus modos aplicáveis para permitir que os clientes definam ligações de teclas para um atalho de ativação. O ID do comando para uma rotina de tratamento é gerado como o atributo do ID do atalho de ativação, seguido por um ponto e o modo de ativação aplicável. Por exemplo, o ID de comando para o exemplo de atalho de ativação acima será com.example.ExampleLaunchShortcutId.debug para ativação em modo de depuração. Um comando e a ligação de teclas podem ser definidos da seguinte maneira, para ligar o "ALT-SHIFT-D, E" com o atalho de ativação.

   

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