| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML> |
| <HEAD> |
| <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"> |
| <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> |
| |
| <LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css"> |
| <TITLE>Debug action groups</TITLE> |
| |
| <link rel="stylesheet" type="text/css" HREF="../book.css"> |
| </HEAD> |
| <BODY BGCOLOR="#ffffff"> |
| <h3>Debug action groups</h3> |
| <p>Because the platform is designed to support many different programming |
| languages and tools, it's likely that a user will have several different |
| debugger implementations installed in the workbench. Typically, a |
| developer is working and debugging in one language at a time. However, the |
| debug implementations all share the workbench debug perspective and its |
| associated views. In order to prevent the debug view's tool bars and popup |
| menus from being cluttered, debug plug-ins can specify named groups of |
| debug actions that the user can choose to hide or show in the debugger.</p> |
| <p>Action groups are defined in the <a href="../reference/extension-points/org_eclipse_debug_ui_debugActionGroups.html"><b>org.eclipse.debug.ui.debugActionGroups</b></a> |
| extension point. An action group has an <b>id</b>, <b>name</b>, and <b>visible</b> |
| attribute. The visible attribute determines whether the actions in the |
| group should be shown in debugger views by default. The user can change |
| the visibility from the preferences dialog.</p> |
| <p>The following example shows the markup for the debug action groups in the |
| Java debugger:</p> |
| <pre><font color="#4444CC"><extension point = "org.eclipse.debug.ui.debugActionGroups"><br> <debugActionGroup<br> id = "org.eclipse.jdt.debug.ui.javaDebugActionGroup"<br> visible="true"<br> name="%JavaDebugActionGroup.name"><br> <action id="org.eclipse.jdt.debug.ui.actions.AddException"/><br> <action id="org.eclipse.jdt.ui.breakpointViewActions.ShowQualified"/><br> <action id="org.eclipse.jdt.ui.expressionViewActions.ShowQualified"/><br> <action id="org.eclipse.jdt.ui.expressionViewActions.AddWatchExpression"/><br> <action id="org.eclipse.jdt.ui.launchViewActions.ShowQualified"/><br> <action id="org.eclipse.jdt.ui.variableViewActions.ShowQualified"/><br> <action id="org.eclipse.jdt.ui.variableViewActions.ShowStatic"/><br> <action id="org.eclipse.jdt.ui.expressionViewActions.ShowStatic"/><br> <action id="org.eclipse.jdt.ui.variableViewActions.ShowConstants"/><br> <action id="org.eclipse.jdt.ui.expressionViewActions.ShowConstants"/><br> <action id="org.eclipse.jdt.ui.expressionViewActions.PrimitiveOptions"/><br> <action id="org.eclipse.jdt.ui.variableViewActions.PrimitiveOptions"/><br> </debugActionGroup><br></extension></font></pre> |
| <p>Note that the name specified in the extension point is what appears in the |
| preferences dialog.</p> |
| <p><img src="images/debugactiongroups.gif" alt="Preferences dialog with debug action groups" border="0" width="522" height="541"></p> |
| <p><a href="../hglegal.htm"><img border="0" src="../ngibmcpy.gif" alt="Copyright IBM Corporation and others 2000, 2003." border="0" width="324" height="14"></a></p> |
| </BODY> |
| </HTML> |