blob: 77534ed523f36f74b53d7f711e71b2a28bd6fca3 [file] [log] [blame]
<!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.&nbsp; Typically, a
developer is working and debugging in one language at a time.&nbsp; However, the
debug implementations all share the workbench debug perspective and its
associated views.&nbsp; 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.&nbsp; An action group has an <b>id</b>, <b>name</b>, and <b>visible</b>
attribute.&nbsp; The visible attribute determines whether the actions in the
group should be shown in debugger views by default.&nbsp; 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">&lt;extension point = &quot;org.eclipse.debug.ui.debugActionGroups&quot;&gt;<br> &lt;debugActionGroup<br> id = &quot;org.eclipse.jdt.debug.ui.javaDebugActionGroup&quot;<br> visible=&quot;true&quot;<br> name=&quot;%JavaDebugActionGroup.name&quot;&gt;<br> &lt;action id=&quot;org.eclipse.jdt.debug.ui.actions.AddException&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.breakpointViewActions.ShowQualified&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.expressionViewActions.ShowQualified&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.expressionViewActions.AddWatchExpression&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.launchViewActions.ShowQualified&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.variableViewActions.ShowQualified&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.variableViewActions.ShowStatic&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.expressionViewActions.ShowStatic&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.variableViewActions.ShowConstants&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.expressionViewActions.ShowConstants&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.expressionViewActions.PrimitiveOptions&quot;/&gt;<br> &lt;action id=&quot;org.eclipse.jdt.ui.variableViewActions.PrimitiveOptions&quot;/&gt;<br> &lt;/debugActionGroup&gt;<br>&lt;/extension&gt;</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>