Launch Configuration Tabs

Identifier:

org.eclipse.debug.ui.launchConfigurationTabs

Since:

3.3

Description:

This extension point is to contribute launch configuration tabs (one or more) to an existing launch configuration tab group.

Configuration Markup:

<!ELEMENT extension (tab)+>

<!ATTLIST extension

point CDATA #REQUIRED>

<!ELEMENT tab (placement? , associatedDelegate*)>

<!ATTLIST tab

id CDATA #REQUIRED

group IDREF #REQUIRED

name CDATA #REQUIRED

class CDATA #REQUIRED>

describes an individual launch configuration tab contribution

id - the unique id of this contributed tab
group - the unique id of an existnig ILaunchConfigurationTabGroup that this tab should be contributed to
name - a human readable name for this tab. The provided name does not have to be the name that appears on the tab itself, but should sufficiently describe the tab.
class - fully qualified name of the java class that implements ILaunchConfigurationTab.

<!ELEMENT placement EMPTY>

<!ATTLIST placement

after CDATA #REQUIRED>

This element allows contributors to specify relative locale for their contributed tab

after - Specifies the id of the tab that this tab should appear immediately after in the left to right arrangement of tabs. The ID specified here should match the value returned by org.eclipse.debug.ui.AbstractLaunchConfigurationTab.getID(), which may be different than the ID specified in the tab declaration of this extension point.

<!ELEMENT associatedDelegate EMPTY>

<!ATTLIST associatedDelegate

delegate IDREF #REQUIRED>

This attribute is used to map a contrinbuted tab to one or more launch delegates. This allows tabs to be filtered from the launch dialog based on what launch delegate is selected as the current default. For example, if two plug-ins contribute launch delegates and tabs for the same launch mode, only one set of tabs will be displayed to the user based on the enabled delegate chosen by the user.

delegate - The id of the launchDelegate that this tab is associated with. The association allows the tab to be filtered based on the modesets supported by the delegates.

Examples:

The following example adds the tab "FooTab" to the local java application launch tab group.


<extension point="org.eclipse.debug.ui.launchConfigurationTabs">
    <tab
       class="org.eclipse.jdt.debug.ui.launchConfigurations.FooTab"
        group="org.eclipse.jdt.debug.ui.launchConfigurationTabGroup.localJavaApplication"
        id="org.eclipse.jdt.debug.ui.fooTab"
        name="Foo Tab">
    </tab>
 </extension>

Supplied Implementation:

The debug platform provides two abstract classes that clients should subclass when implementing launch tabs. See AbstractLaunchConfigurationTab and AbstractOptionLaunchConfigurationTab in package org.eclipse.debug.ui.

Copyright (c) 2006 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