| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| </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"> <!ELEMENT extension (launchConfigurationType*)></font></samp> |
| <br><br><samp><font color="#800000"> <!ATTLIST extension</samp> |
| <br><samp> point CDATA #REQUIRED</samp> |
| <br><samp> id CDATA #IMPLIED</samp> |
| <br><samp> name CDATA #IMPLIED</samp> |
| <br><samp> ></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"> <!ELEMENT launchConfigurationType (fileExtension+)></font></samp> |
| <br><br><samp><font color="#800000"> <!ATTLIST launchConfigurationType</samp> |
| <br><samp> id CDATA #REQUIRED</samp> |
| <br><samp> delegate CDATA #REQUIRED</samp> |
| <br><samp> modes CDATA #REQUIRED</samp> |
| <br><samp> name CDATA #REQUIRED</samp> |
| <br><samp> public (true | false) </samp> |
| <br><samp> category CDATA #IMPLIED</samp> |
| <br><samp> ></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"> <!ELEMENT fileExtension EMPTY></font></samp> |
| <br><br><samp><font color="#800000"> <!ATTLIST fileExtension</samp> |
| <br><samp> extension CDATA #REQUIRED</samp> |
| <br><samp> default (true | false) </samp> |
| <br><samp> ></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"><extension point=<font color="#008000">"org.eclipse.debug.core.launchConfigurationTypes"</font>></font> |
| <font color="#000080"><launchConfigurationType |
| id=<font color="#008000">"com.example.ExampleIdentifier"</font> |
| delegate=<font color="#008000">"com.example.ExampleLaunchConfigurationDelegate"</font> |
| modes=<font color="#008000">"run,debug"</font> |
| name=<font color="#008000">"Example Application"</font>></font> |
| <font color="#000080"><fileExtension extension=<font color="#008000">"txt"</font> default=<font color="#008000">"true"</font>/></font> |
| <font color="#000080"><fileExtension extension=<font color="#008000">"gif"</font> default=<font color="#008000">"false"</font>/></font> |
| <font color="#000080"></launchConfigurationType></font> |
| <font color="#000080"></extension></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"> |
| <a href="hglegal.htm"><img SRC="ngibmcpy.gif" ALT="Copyright IBM Corp. 2000, 2003. All Rights Reserved." BORDER=0 height=12 width=195></a><p> |
| </font> |
| </BODY> |
| </HTML> |