<!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>
org.eclipse.debug.ui.ILaunchShortcut
.null
(par défaut).path
puis triés par ordre alphabétique au sein des groupes basés sur l'attribut label
. Sans précision, un raccourci apparaît dans le dernier groupe. Cet attribut a été ajouté dans la version 3.0.1.<!ELEMENT perspective EMPTY>
<!ATTLIST perspective
id CDATA #REQUIRED>
L'élément perspective
a été déconseillé dans la version 3.1. Les menus en cascade Exécuter/Déboguer/Profiler de niveau supérieur prennent désormais en charge le lancement contextuel (sélection contextuelle) et les clients doivent fournir un élément contextualLaunch
à la place.
<!ELEMENT contextualLaunch (contextLabel* , enablement?)>
Rassemble toutes les descriptions pour l'ajout de raccourcis aux menus en cascade Exécuter/Déboguer/Profiler à sélection contextuelle.
<!ELEMENT contextLabel EMPTY>
<!ATTLIST contextLabel
mode (run|debug|profile)
label CDATA #REQUIRED>
Indiquez l'intitulé d'un mode de lancement contextuel.
<!ELEMENT enablement (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate)*>
Elément racine générique. Il peut être utilisé dans un point d'extension pour définir son expression d'activation. Les enfants d'une expression d'activation sont combinés à l'aide de l'opérateur and.
<!ELEMENT not (not | and | or | instanceof | test | systemTest | equals | count | with | resolve | adapt | iterate)>
Cet élément représente une opération NOT sur le résultat d'évaluation de l'expression de son sous-élément.
<!ELEMENT and (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate)*>
Cet élément représente une opération AND sur le résultat d'évaluation de toutes les expressions de ses sous-éléments.
<!ELEMENT or (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate)*>
Cet élément représente une opération OR sur le résultat d'évaluation de toutes les expressions de son sous-élément.
<!ELEMENT instanceof EMPTY>
<!ATTLIST instanceof
value CDATA #REQUIRED>
Cet élément est employé pour effectuer une vérification d'instance de l'objet activé. L'expression renvoie EvaluationResult.TRUE si le type d'objet est un sous-type du type spécifié par la valeur de l'attribut. Sinon, elle retourne EvaluationResult.FALSE.
<!ELEMENT test EMPTY>
<!ATTLIST test
property CDATA #REQUIRED
args CDATA #IMPLIED
value CDATA #IMPLIED>
Cet élément est employé pour évaluer l'état de propriété de l'objet activé. L'ensemble des propriétés pouvant être testées peut être étendu à l'aide du point d'extension de testeur de propriétés. L'expression de test renvoie EvaluationResult.NOT_LOADED si le testeur de propriétés n'est pas encore chargé.
<!ELEMENT systemTest EMPTY>
<!ATTLIST systemTest
property CDATA #REQUIRED
value CDATA #REQUIRED>
Teste une propriété système en appelant la méthode System.getProperty et compare le résultat avec la valeur indiquée par l'attribut.
<!ELEMENT equals EMPTY>
<!ATTLIST equals
value CDATA #REQUIRED>
Cet élément est employé pour effectuer une vérification d'équivalence de l'objet activé. L'expression renvoie EvaluationResult.TRUE si l'objet équivaut à la valeur indiquée par l'attribut. Sinon, elle retourne EvaluationResult.FALSE.
<!ELEMENT count EMPTY>
<!ATTLIST count
value CDATA #REQUIRED>
Cet élément est employé pour tester le nombre d'éléments dans une collection.
<!ELEMENT with (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate)*>
<!ATTLIST with
variable CDATA #REQUIRED>
Cet élément remplace l'objet à contrôler pour tous ses éléments enfants par celui auquel la variable donnée fait référence. Si la variable ne peut être résolue, l'expression renvoie ExpressionException à son évaluation. Les enfants avec une expression sont combinés avec l'opérateur and.
<!ELEMENT resolve (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate)*>
<!ATTLIST resolve
variable CDATA #REQUIRED
args CDATA #IMPLIED>
Cet élément remplace l'objet à contrôler pour tous ses éléments enfants par celui auquel la variable donnée fait référence. Si la variable ne peut être résolue, l'expression renvoie ExpressionException à son évaluation. Les enfants avec une expression sont combinés avec l'opérateur and.
<!ELEMENT adapt (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate)*>
<!ATTLIST adapt
type CDATA #REQUIRED>
Cet élément est employé pour adapter l'objet activé au type indiqué par le type d'attribut. L'expression renvoie not loaded si l'adaptateur ou le type référencés ne sont pas encore chargés. Elle lance ExpressionException au cours de l'évaluation si le nom du type n'existe pas. Les enfants d'une expression d'adaptation sont combinés avec l'opérateur and.
<!ELEMENT iterate (not , and , or , instanceof , test , systemTest , equals , count , with , resolve , adapt , iterate)*>
<!ATTLIST iterate
operator (or|and) >
Cet élément est employé pour itérer sur une variable de type java.util.Collection. Si l'objet activé n'est pas de type java.util.Collection, une exception ExpressionException est lancée lors de l'évaluation de l'expression.
Dans cet exemple, un raccourci de lancement s'affiche dans les menus en cascade d'exécution et de débogage avec le libellé "Example Launch Shortcut", dans JavaPerspective et DebugPerspective.<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>
La valeur de l'attribut class doit correspondre au nom qualifié complet d'une classe Java implémentant l'interface org.eclipse.debug.ui.ILaunchShortcut.
Depuis la version 3.1, la plateforme de débogage enregistre un gestionnaire de commande pour chaque raccourci de lancement et ses modes applicables afin de permettre aux clients de définir des liaisons de touche pour un raccourci de lancement. L'ID de la commande du gestionnaire est généré en tant qu'attribut de l'ID du raccourci de lancement, suivi d'un point et du mode de lancement applicable. Par exemple, l'ID de la commande pour l'exemple de raccourci de lancement ci-dessus serait com.example.ExampleLaunchShortcutId.debug
pour un lancement en mode de débogage. Une commande et une liaison de touches pourraient être définies de la manière suivante, pour lier "ALT-SHIFT-D, E
" au raccourci de lancement.
<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>
Copyright (c) 2000, 2005 IBM Corporation and others.
All rights reserved. Ce programme et les produits associés sont
distribués sous licence publique Eclipse v1.0 et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/epl-v10.html