Skip to main content
summaryrefslogtreecommitdiffstats
blob: dd222083df03bae9e50baefec92dad9bb38db47f (plain) (blame)
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<STYLE type="text/css">
div.dtd-fragment {
	width: 100%;
	border: none;
	background-color: #eee;
}
</STYLE>
</HEAD>
<HTML>
<BODY>
<H1><CENTER>Launch Configuration Types</CENTER></H1>
<b><i>Identifier: </i></b>org.eclipse.debug.core.launchConfigurationTypes<p>
<b><i>Description: </i></b>This extension point provides a configurable mechanism for launching applications.
Each launch configuration type has a name, supports one or more modes (run and/or debug), and specifies a delegate
responsible for the implementation of launching an application.<p><b><i>Configuration Markup:</i></b><p>
<p><samp><font color="#800000">&nbsp;&nbsp; &lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.launchConfigurationType">launchConfigurationType</a>*)&gt;</font></samp>
<br><br><samp><font color="#800000">&nbsp;&nbsp; &lt;!ATTLIST extension</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;point&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name&nbsp;&nbsp;CDATA #IMPLIED</samp>
<br><samp>&nbsp;&nbsp; &gt;</font></samp>
<ul>
<li><b>point</b> - a fully qualified identifier of the target extension point</li>
<li><b>id</b> - an optional identifier of the extension instance</li>
<li><b>name</b> - an optional name of the extension instance</li>
</ul>
<p><samp><font color="#800000">&nbsp;&nbsp; &lt;!ELEMENT <a name="e.launchConfigurationType">launchConfigurationType</a> (<a href="#e.fileExtension">fileExtension</a>+)&gt;</font></samp>
<br><br><samp><font color="#800000">&nbsp;&nbsp; &lt;!ATTLIST launchConfigurationType</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;id&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;delegate&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;modes&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;public&nbsp;&nbsp;&nbsp;(true | false) </samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;category&nbsp;CDATA #IMPLIED</samp>
<br><samp>&nbsp;&nbsp; &gt;</font></samp>
<ul>
<li><b>id</b> - specifies a unique identifier for this launch configuration type.</li>
<li><b>delegate</b> - specifies the fully qualified name of the Java class that implements <samp>ILaunchConfigurationDelegate</samp>.
Launch configuration instances of this type will delegate to instances of this class to perform launching.</li>
<li><b>modes</b> - specifies a comma-separated list of the modes this type of lauch configuration supports - "run" and/or "debug".</li>
<li><b>name</b> - specifies a human-readable name for this type of launch configuration.</li>
<li><b>public</b> - specifies whether this launch configuration type is accessible by users.  Defaults to true if not specified.</li>
<li><b>category</b> - an optional attribute that specifies this launch configuration type's category. The default value is unspecified (null). Categories are client defined. This attribute was added in the 2.1 release.</li>
</ul>
<p><samp><font color="#800000">&nbsp;&nbsp; &lt;!ELEMENT <a name="e.fileExtension">fileExtension</a> EMPTY&gt;</font></samp>
<br><br><samp><font color="#800000">&nbsp;&nbsp; &lt;!ATTLIST fileExtension</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;extension&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;default&nbsp;&nbsp;&nbsp;(true | false) </samp>
<br><samp>&nbsp;&nbsp; &gt;</font></samp>
<ul>
<li><b>extension</b> - specifies a file extension that this launch configuration type
can be used for.</li>
<li><b>default</b> - specifies whether this launch configuration type should be the default launch configuration type for the specified file extension.  Defaults to false if not specified.</li>
</ul>
<b><i>Examples: </i></b>The following is an example of a launch configuration type extension point:

<p>
<pre>
 <font color="#000080">&lt;extension point=<font color="#008000">&quot;org.eclipse.debug.core.launchConfigurationTypes&quot;</font>&gt;</font>
  <font color="#000080">&lt;launchConfigurationType
   id=<font color="#008000">&quot;com.example.ExampleIdentifier&quot;</font>
   delegate=<font color="#008000">&quot;com.example.ExampleLaunchConfigurationDelegate&quot;</font>
   modes=<font color="#008000">&quot;run,debug&quot;</font>
   name=<font color="#008000">&quot;Example Application&quot;</font>&gt;</font>
   <font color="#000080">&lt;fileExtension extension=<font color="#008000">&quot;txt&quot;</font> default=<font color="#008000">&quot;true&quot;</font>/&gt;</font>
   <font color="#000080">&lt;fileExtension extension=<font color="#008000">&quot;gif&quot;</font> default=<font color="#008000">&quot;false&quot;</font>/&gt;</font>
  <font color="#000080">&lt;/launchConfigurationType&gt;</font>
 <font color="#000080">&lt;/extension&gt;</font>
</pre>
</p>

In the example above, the specified type of launch configuration supports both run and debug modes. 
The launch configuration is applicable to .txt and .gif files, and is the default launch configuration for .txt files.<p>
<b><i>API Information: </i></b>Value of the attribute <b>delegate</b> must be a fully qualified name of a Java class that implements the interface <b>org.eclipse.debug.core.model.ILaunchConfigurationDelegate</b>.<p>
<font size="-1" color="#336699">
<p>
<a href="hglegal.htm">
 <img SRC="ngibmcpy.gif"
   ALT="Copyright (c) 2000, 2003 IBM Corporation and others. All Rights Reserved."
   BORDER=0 height=14 width=324></a>
</p><p>
</font>
</BODY>
</HTML>

Back to the top