Launch Groups

Identifier:
org.eclipse.debug.ui.launchGroups

Since:
2.1

Description:
This extension point provides support for defining a group of launch configurations to be viewed together in the launch configuration dialog, and support a launch history (recent and favorite launches).

Configuration Markup:

<!ELEMENT extension (launchGroup*)>

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

<!ATTLIST launchGroup

id          CDATA #REQUIRED
mode        CDATA #REQUIRED
category    CDATA #IMPLIED
label       CDATA #REQUIRED
image       CDATA #REQUIRED
bannerImage CDATA #REQUIRED
public      CDATA #IMPLIED>

id - specifies a unique identifier for this launch group.
mode - specifies the launch mode associated with this group - i.e. run or debug.
category - specifies the category of launch configurations in this group. When unspecified, the category is null.
label - specifies a translatable label used to render this group.
image - specifies a plug-in relative path to an image used to render this group in trees, lists, tabs, etc.
bannerImage - specifies a plug-in relative path to an image used to render this group in a wizard or dialog banner area.
public - specifies whether this launch group is public and should be have a visible launch history tab in the debug preferences. The implied value is true, when not specified.

Examples:
The following is an example of a launch group extension point:
 <extension point=
"org.eclipse.debug.ui.launchGroups"
>
  <launchGroup
     id=
"com.example.ExampleLaunchGroupId"

     mode=
"run"

     label=
"Run"

     image=
"icons\run.gif"

     bannerImage=
"icons\runBanner.gif"
>
  </launchGroup>
 </extension>
In the above example, the launch group will consist of all launch configurations with no category that support run mode.

Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Common Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html