public interface ILaunchConfigurationDelegate
delegate
attribute
of a launchConfigurationType
extension.
This interface is intended to be implemented by clients.
ILaunchConfigurationType
,
ILaunchConfiguration
Modifier and Type | Method and Description |
---|---|
void |
launch(ILaunchConfiguration configuration,
String mode,
ILaunch launch,
IProgressMonitor monitor)
Launches the given configuration in the specified mode, contributing
debug targets and/or processes to the given launch object.
|
default String |
showCommandLine(ILaunchConfiguration configuration,
String mode,
ILaunch launch,
IProgressMonitor monitor)
Gets the command line to launch the given configuration in the specified
mode, contributing debug targets and/or processes to the given launch
object.
|
void launch(ILaunchConfiguration configuration, String mode, ILaunch launch, IProgressMonitor monitor) throws CoreException
configuration
- the configuration to launchmode
- the mode in which to launch, one of the mode constants
defined by ILaunchManager
-
RUN_MODE
or DEBUG_MODE
.monitor
- progress monitor, or null
progress monitor, or null
. A cancelable progress
monitor is provided by the Job framework. It should be noted that the setCanceled(boolean) method should
never be called on the provided monitor or the monitor passed to any delegates from this method; due to a
limitation in the progress monitor framework using the setCanceled method can cause entire workspace batch
jobs to be canceled, as the canceled flag is propagated up the top-level parent monitor.
The provided monitor is not guaranteed to have been started.launch
- the launch object to contribute processes and debug
targets toCoreException
- if launching failsdefault String showCommandLine(ILaunchConfiguration configuration, String mode, ILaunch launch, IProgressMonitor monitor) throws CoreException
configuration
- the configuration to launchmode
- the mode in which to launch, one of the mode constants
defined by ILaunchManager
- RUN_MODE
or DEBUG_MODE
.monitor
- progress monitor, or null
progress monitor,
or null
. A cancelable progress monitor is
provided by the Job framework. It should be noted that the
setCanceled(boolean) method should never be called on the
provided monitor or the monitor passed to any delegates from
this method; due to a limitation in the progress monitor
framework using the setCanceled method can cause entire
workspace batch jobs to be canceled, as the canceled flag is
propagated up the top-level parent monitor. The provided
monitor is not guaranteed to have been started.launch
- the launch object to contribute processes and debug targets
toCoreException
- if launching fails
Copyright (c) 2000, 2018 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.