1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
/*******************************************************************************
* Copyright (c) 2000, 2003 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Common Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/cpl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.debug.ui;
import org.eclipse.jface.viewers.ISelection;
import org.eclipse.ui.IEditorPart;
/**
* A launch shortcut is capable of launching a selection
* or active editor in the workbench. The delegate is responsible for
* interpretting the selection or active editor (if it applies), and launching
* an application. This may require creating a new launch configuration
* with default values, or re-using an existing launch configuration.
* <p>
* A launch shortcut is defined as an extension
* of type <code>org.eclipse.debug.ui.launchShortcuts</code>.
* A shortcut specifies the perspectives in which is should be available
* from the "Run/Debug" cascade menus.
* </p>
* <p>
* A launch shortcut extension is defined in <code>plugin.xml</code>.
* Following is an example definition of a launch shortcut extension.
* <pre>
* <extension point="org.eclipse.debug.ui.launchShortcuts">
* <launchShortcut
* id="com.example.ExampleLaunchShortcut"
* class="com.example.ExampleLaunchShortcutClass"
* label="Example Label"
* icon="\icons\exampleshortcut.gif"
* modes="run, debug">
* <perspective id="com.example.perspectiveId1"/>
* <perspective id="com.example.perspectiveId2"/>
* </launchShortcut>
* </extension>
* </pre>
* The attributes are specified as follows:
* <ul>
* <li><code>id</code> specifies a unique identifier for this launch shortcut.</li>
* <li><code>class</code> specifies a fully qualified name of a Java class
* that implements <code>IlaunchShortcut</code>.</li>
* <li><code>label</code> specifies a label used to render this shortcut.</li>
* <li><code>icon</code> specifies a plug-in relative path to an icon used to
* render this shortcut.</li>
* <li><code>modes</code> specifies a comma separated list of modes this shortcut
* supports.</li>
* <li><code>perspective</code> one or more perspective entries enumerate the
* perspectives that this shortcut is avilable in, from the run/debug cascade
* menus.</li>
* </ul>
* </p>
* @since 2.0
*/
public interface ILaunchShortcut {
/**
* Locates a launchable entity in the given selection and launches
* an application in the specified mode. This launch configuration
* shortcut is responsible for progress reporting as well
* as error handling, in the event that a launchable entity cannot
* be found, or launching fails.
*
* @param selection workbench selection
* @param mode one of the launch modes defined by the
* launch manager
* @see org.eclipse.debug.core.ILaunchManager
*/
public void launch(ISelection selection, String mode);
/**
* Locates a launchable entity in the given active editor, and launches
* an application in the specified mode. This launch configuration
* shortcut is responsible for progress reporting as well as error
* handling, in the event that a launchable entity cannot be found,
* or launching fails.
*
* @param editor the active editor in the workbench
* @param mode one of the launch modes defined by the launch
* manager
* @see org.eclipse.debug.core.ILaunchManager
*/
public void launch(IEditorPart editor, String mode);
}
|