/*******************************************************************************
* Copyright (c) 2000, 2008 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.debug.core;
/**
* A launch mode. The debug platform contributes launch modes
* for run, debug, and profile. Clients may contribute additional launch
* modes in plug-in XML via the launchModes
extension point.
*
* Following is an example launch mode contribution for profiling. A launch
* mode has an unique identifier specified by the mode
attribute
* and a human readable label specified by the label
attribute.
*
* <extension point="org.eclipse.debug.core.launchModes"> * <launchMode * mode="profile" * label="Profile"> * </launchMode> * </extension> ** * @since 3.0 * @noimplement This interface is not intended to be implemented by clients. * @noextend This interface is not intended to be extended by clients. */ public interface ILaunchMode { /** * Returns the unique identifier for this launch mode. * * @return the unique identifier for this launch mode */ public String getIdentifier(); /** * Returns a human readable label for this launch mode. * * @return a human readable label for this launch mode */ public String getLabel(); /** * Returns a human readable label for this launch mode when used in a * cascade menu. For example, "Run As". Allows the label to be * properly externalized. *
* A new attribute has been added the the launch mode extension in 3.2 * to specify this label. When unspecified a default label is generated * by concatenation, for backwards compatibility. *
* @return human readable label for this launch mode when used in a * cascade menu * @since 3.2 */ public String getLaunchAsLabel(); }