#
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