| <!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> <!ELEMENT launchConfigurationType (fileExtension?)</tt>> | |
| <tt> <!ATTLIST launchConfigurationType</tt> | |
| <br><tt> id CDATA #REQUIRED</tt> | |
| <br><tt> delegate CDATA #REQUIRED</tt> | |
| <br><tt> modes CDATA #REQUIRED</tt> | |
| <br><tt> name CDATA #REQUIRED</tt>> | |
| <br><tt> public CDATA (true | false) #IMPLIED</tt>> | |
| </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> | |
| <li><code>public</code> specifies whether this launch configuration type is | |
| accessible by users. Defaults to true if not specified.</li> | |
| </ul> | |
| <pre> | |
| <tt> <!ATTLIST fileExtension</tt> | |
| <br><tt> extension CDATA #REQUIRED</tt> | |
| <br><tt> default CDATA (true | false) #IMPLIED</tt>> | |
| </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> | |
| <extension point="org.eclipse.debug.core.launchConfigurationTypes"> | |
| <launchConfigurationType | |
| id="com.example.ExampleIdentifier" | |
| delegate="com.example.ExampleLaunchConfigurationDelegate" | |
| modes="run, debug" | |
| name="Example Application"> | |
| <fileExtension | |
| extension="txt" | |
| default=true> | |
| <fileExtension | |
| extension="gif" | |
| default=false> | |
| </launchConfigurationType> | |
| </extension> | |
| </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> |