Package org.eclipse.debug.ui
Interface ILaunchConfigurationDialog
-
- All Superinterfaces:
IRunnableContext
public interface ILaunchConfigurationDialog extends IRunnableContext
A launch configuration dialog is used to edit and launch launch configurations. It contains a launch configuration tab group.- Since:
- 2.0
- See Also:
ILaunchConfigurationTabGroup
,ILaunchConfigurationTab
- Restriction:
- This interface is not intended to be implemented by clients.
- Restriction:
- This interface is not intended to be extended by clients.
-
-
Field Summary
Fields Modifier and Type Field Description static int
LAUNCHED_BEFORE_OPENING
Deprecated.the launch dialog no longer supports launching without opening - this constant will never be returned by the dialog
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description String
generateName(String name)
Returns a unique launch configuration name, using the given name as a seed.ILaunchConfigurationTab
getActiveTab()
Returns the currently activeILaunchConfigurationTab
being displayed, ornull
if there is none.String
getMode()
Returns the mode in which this dialog was opened - run or debug.ILaunchConfigurationTab[]
getTabs()
Returns the tabs currently being displayed, ornull
if none.void
setActiveTab(int index)
Sets the displayed tab to the tab with the given index.void
setActiveTab(ILaunchConfigurationTab tab)
Sets the displayed tab to the given tab.void
setName(String name)
Sets the contents of the name field to the given name.void
updateButtons()
Adjusts the enable state of this dialog's buttons to reflect the state of the active tab group.void
updateMessage()
Updates the message (or error message) shown in the message line to reflect the state of the currently active tab in this launch configuration dialog.-
Methods inherited from interface org.eclipse.jface.operation.IRunnableContext
run
-
-
-
-
Field Detail
-
LAUNCHED_BEFORE_OPENING
@Deprecated static final int LAUNCHED_BEFORE_OPENING
Deprecated.the launch dialog no longer supports launching without opening - this constant will never be returned by the dialogReturn value fromopen()
method of a launch configuration dialog when a launch completed successfully with a single click (without opening a launch configuration dialog).- See Also:
- Constant Field Values
-
-
Method Detail
-
updateButtons
void updateButtons()
Adjusts the enable state of this dialog's buttons to reflect the state of the active tab group.This may be called by to force a button state update.
-
updateMessage
void updateMessage()
Updates the message (or error message) shown in the message line to reflect the state of the currently active tab in this launch configuration dialog.This method may be called to force a message update.
-
setName
void setName(String name)
Sets the contents of the name field to the given name.- Parameters:
name
- new name value
-
generateName
String generateName(String name)
Returns a unique launch configuration name, using the given name as a seed.- Parameters:
name
- seed from which to generate a new unique name- Returns:
- the new unique launch configuration name
-
getTabs
ILaunchConfigurationTab[] getTabs()
Returns the tabs currently being displayed, ornull
if none.- Returns:
- currently displayed tabs, or
null
-
getActiveTab
ILaunchConfigurationTab getActiveTab()
Returns the currently activeILaunchConfigurationTab
being displayed, ornull
if there is none.- Returns:
- currently active
ILaunchConfigurationTab
, ornull
.
-
getMode
String getMode()
Returns the mode in which this dialog was opened - run or debug.- Returns:
- one of
RUN_MODE
orDEBUG_MODE
defined inILaunchManager
- See Also:
ILaunchManager
-
setActiveTab
void setActiveTab(ILaunchConfigurationTab tab)
Sets the displayed tab to the given tab. Has no effect if the specified tab is not one of the tabs being displayed in the dialog currently.- Parameters:
tab
- the tab to display/activate- Since:
- 2.1
-
setActiveTab
void setActiveTab(int index)
Sets the displayed tab to the tab with the given index. Has no effect if the specified index is not within the limits of the tabs returned bygetTabs()
.- Parameters:
index
- the index of the tab to display- Since:
- 2.1
-
-