| <!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 Groups</CENTER></H1> |
| <b><i>Identifier: </i></b>org.eclipse.debug.ui.launchGroups<p> |
| <b><i>Since: </i></b>2.1<p> |
| <b><i>Description: </i></b>This extension point provides support for defining a group of launch configurations to be viewed together in the launch configuration dialog, and support a launch history (recent and favorite launches).<p><b><i>Configuration Markup:</i></b><p> |
| <p><samp><font color="#800000"> <!ELEMENT extension EMPTY></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 launchGroup EMPTY></font></samp> |
| <br><br><samp><font color="#800000"> <!ATTLIST launchGroup</samp> |
| <br><samp> id CDATA #REQUIRED</samp> |
| <br><samp> mode CDATA #REQUIRED</samp> |
| <br><samp> category CDATA #IMPLIED</samp> |
| <br><samp> label CDATA #REQUIRED</samp> |
| <br><samp> image CDATA #REQUIRED</samp> |
| <br><samp> bannerImage CDATA #REQUIRED</samp> |
| <br><samp> public CDATA #IMPLIED</samp> |
| <br><samp> ></font></samp> |
| <ul> |
| <li><b>id</b> - specifies a unique identifier for this launch group.</li> |
| <li><b>mode</b> - specifies the launch mode associated with this group - i.e. run or debug.</li> |
| <li><b>category</b> - specifies the category of launch configurations in this group. When unspecified, the category is null.</li> |
| <li><b>label</b> - specifies a translatable label used to render this group.</li> |
| <li><b>image</b> - specifies a plug-in relative path to an image used to render this group in trees, lists, tabs, etc.</li> |
| <li><b>bannerImage</b> - specifies a plug-in relative path to an image used to render this group in a wizard or dialog banner area.</li> |
| <li><b>public</b> - specifies whether this launch group is public and should be have a visible launch history tab in the debug preferences. The implied value is true, when not specified.</li> |
| </ul> |
| <b><i>Examples: </i></b>The following is an example of a launch group extension point: |
| <p> |
| <pre> |
| <font color="#000080"><extension point=<font color="#008000">"org.eclipse.debug.ui.launchGroups"</font>></font> |
| <font color="#000080"><launchGroup |
| id=<font color="#008000">"com.example.ExampleLaunchGroupId"</font> |
| mode=<font color="#008000">"run"</font> |
| label=<font color="#008000">"Run"</font> |
| icon=<font color="#008000">"icons\run.gif"</font> |
| bannerImage=<font color="#008000">"icons\runBanner.gif"</font>></font> |
| <font color="#000080"></launchGroup></font> |
| <font color="#000080"></extension></font> |
| </pre> |
| </p> |
| In the above example, the launch group will consist of all launch configurations with no category that support run mode.<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> |