# 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 IDREF #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 IDREF #REQUIRED

perspective IDREF #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, 2005 IBM Corporation and others.
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v20.html/ SPDX-License-Identifier: EPL-2.0