Launch Configuration Tab Groups

Identifier:

org.eclipse.debug.ui.launchConfigurationTabGroups

Description:

This extension point provides a mechanism for contributing a group of tabs to the launch configuration dialog for a type of launch configuration.

Configuration Markup:

<!ELEMENT extension (launchConfigurationTabGroup*)>

<!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 launchConfigurationTabGroup (launchMode*)>

<!ATTLIST launchConfigurationTabGroup

id            CDATA #REQUIRED

type          CDATA #REQUIRED

class         CDATA #REQUIRED

helpContextId CDATA #IMPLIED

description   CDATA #IMPLIED>

• id - specifies a unique identifier for this launch configuration tab group.

• type - specifies a launch configuration type that this tab group is applicable to (corresponds to the id of a launch configuration type extension).

• class - specifies a fully qualified name of a Java class that implements ILaunchConfigurationTabGroup.

• helpContextId - an optional identifier that specifies the help context to associate with this tab group's launch configuration type

• description - A description of the Launch Configuration Type

<!ELEMENT launchMode EMPTY>

<!ATTLIST launchMode

mode        CDATA #REQUIRED

perspective CDATA #IMPLIED

description CDATA #IMPLIED>

A launch mode element specifies a launch mode this tab group is specific to. A tab group can be associated with one or more launch modes. For backwards compatibility (previous to 3.0), a launch mode does not need to be specified. When unspecified, a tab group is registered as the default tab group for the associated launch configration type (i.e. applicable to all supported launch modes for which a specific tab group has not been contributed).

• mode - identifier for a launch mode this tab group is specific to.

• perspective - the default perspective identifier associated with this launch configuration type and launch mode. This allows an extension to cause a perspective switch (or open) when a corresponding launch is registered with the debug plug-in. When unspecified, it indicates that by default, no perspective switch should occurr.

• description - A description of the Launch Configuration Type specific to this launchMode.

Examples:

The following is an example of a launch configuration tab group extension point:

 
<extension point=
"org.eclipse.debug.ui.launchConfigurationTabGroups"
>
  
<launchConfigurationTabGroup
      id=
"com.example.ExampleTabGroup"

      type=
"com.example.ExampleLaunchConfigurationTypeIdentifier"

      class=
"com.example.ExampleLaunchConfigurationTabGroupClass"
>
  
</launchConfigurationTabGroup>
 
</extension>

In the above example, the contributed tab group will be shown for the launch configuration type with identifier com.example.ExampleLaunchConfigurationTypeIdentifier.

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

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