Skip to main content
aboutsummaryrefslogtreecommitdiffstats
blob: 1e7e63e8d6ee7a2230592621e1840451e236f92c (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
87
88
89
90
91
92
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>

<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>README Launch Configuration Types Extension Point</title>
</head>

<body link="#0000FF" vlink="#800080">

<h1 align="center">Launch Configuration Types</h1>

<p><b><i>Identifier: </i></b>org.eclipse.debug.core.launchConfigurationTypes </p>

<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>

<p><b><i>Configuration Markup:</i></b> </p>

<pre>
<tt>&nbsp;&nbsp; &lt;!ELEMENT launchConfigurationType (fileExtension?)</tt>&gt;
<tt>&nbsp;&nbsp; &lt;!ATTLIST launchConfigurationType</tt> 
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; id&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; delegate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; modes&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; CDATA #REQUIRED</tt>&gt;
</pre>

<ul>
 <li><code>id</code> specifies a unique identifier for this launch configuration
  type.</li>
 <li><code>delegate</code> specifies the fully qualified name of the java class
  that implements <code>ILaunchConfigurationDelegate</code>. Launch configuration
  instances of this type will delegate to instances of this class
  to perform launching.</li>
 <li><code>modes</code> specifies a comma separated list of the modes this
  type of launch configuration suports - <code>"run"</code> and/or <code>"debug"</code>.</li>
 <li><code>name</code> specifies a human readable name for this type
  of launch configuration.</li>
</ul>

<pre>
<tt>&nbsp;&nbsp; &lt;!ATTLIST fileExtension</tt> 
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; extension CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; default&nbsp;&nbsp; CDATA (true | false) #IMPLIED</tt>&gt;
</pre>

<ul>
 <li><code>extension</code> specifies a file extension that this launch configuration type
  can be used for.</li>
 <li><code>default</code> 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>

<p><b><i>Examples:</i></b> </p>

<p>The following is an example of a launch configuration type extension point: </p>

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

<p>In the example above, the specified type of launch configuration supports both run and debug modes.
The launch configuartion is applicable to txt and gif files, and is the default launch configuration
for txt files.
</p>

<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>

<p><a href="hglegal.htm"><img src="ngibmcpy.gif" alt="Copyright IBM Corp. 2000, 2001. All Rights Reserved."
border="0" width="195" height="12"></a></p>
</body>
</html>

Back to the top