Launch Shortcuts

Identifier: org.eclipse.debug.ui.launchShortcuts

Description: This extension point provides support for selection sensitive launching. Extensions register a shortcut which appears in the run and/or debug cascade menus to launch the workbench selection or active editor.

Configuration Markup:

   <!ELEMENT extension (shortcut*)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

point - a fully qualified identifier of the target extension point
id - an optional identifier of the extension instance
name - an optional name of the extension instance

   <!ELEMENT shortcut (perspective*)>

   <!ATTLIST shortcut
     id            CDATA #REQUIRED
     modes         CDATA #REQUIRED
     class         CDATA #REQUIRED
     label         CDATA #REQUIRED
     icon          CDATA #REQUIRED
     category      CDATA #IMPLIED
     helpContextId CDATA #IMPLIED
   >

id - specifies a unique identifier for this launch shortcut.
modes - specifies a comma-separated list of modes this shortcut supports.
class - specifies the fully qualified name of a class which implements org.eclipse.debug.ui.ILaunchShortcut.
label - specifies a label used to render this shortcut.
icon - specifies a plugin-relative path to an image used to render this shortcut.
category - specifies the launch configuration type category this shortcut is applicable for. When unspecified, the category is null (default).
helpContextId - an optional identifier that specifies the help context to associate with this launch shortcut

   <!ELEMENT perspective EMPTY>

   <!ATTLIST perspective
     id CDATA #REQUIRED
   >

id - the unique identifier of a perspective in which a menu shortcut for this launch shortcut will appear.

Examples: The following is an example of a launch shortcut extension point:

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

In the above example, a launch shortcut will be shown in the run and debug cascade menus with the label "Example Launch Shortcut", in the JavaPerspective and the DebugPerspective.

API Information: Value of the attribute class must be a fully qualified name of a Java class that implements the interface org.eclipse.debug.ui.ILaunchShortcut.