Provides a generic debugger user interface that clients may customize via standard workbench extension points.
The Eclipse platform debug UI plug-in provides a set of classes and interfaces to support a language independent debugger user interface. A generic debug perspective is provided with a common set of views. Clients contribute actions to the debug views via the standard workbench extension points.
The Debug View
The debug view presents a tree of launched programs in debug and non-debug (run) mode. The view provides support for standard interactions such as terminating, stepping, suspending, and resuming threads, debug targets, and processes. The debug view is linked to an editor view, variable view, and console. The editor view is used to display source code for stack frames. A selection in the debug view causes the line of code being executed to be highlighted in the editor view. The variable view shows the visible variables in the selected stack frame, and the console view handles I/O for the debuggable process.
The Variables View
The variables view presents a tree of variables for the currently selected stack frame. A "details" area may be hidden/shown which provides a detailed description of the selected variable. For example, the Java debugger displays the result of invoking 'toString()' on the selected variable in this area.
The Breakpoints View
The breakpoints view presents a list of all breakpoints currently defined in the workspace. It supports enabling/disabling and breakpoint removal.
The Expression View
The expression view presents a tree of expressions and their corresponding values.
Debug Model Presentation
The debug UI plug-in defines an extension (org.eclipse.debug.ui.debugModelPresentations) point to allow implementations of debug models to provide custom rendering and presentation of its debug elements. Extensions are registered for a specific debug model. It is intended that an implementation of a debug model will also provide an implementation of a debug model presentation. The presentation provides:
- an image for a debug element or breakpoint
- a label for a debug element or breakpoint
- an editor input and editor id used to display a debug element, breakpoint, or source element
- a detailed description of a variable value, used to display in the "details" section of the variables view
Launch Configuration Dialog
The debug UI plug-in provides a lanuch configuration dialog for creating and editing launch configurations. Clients may contribute tabs to the launch configuration dialog via the launchConfigurationTabGroup extension point.
ClassDescriptionCommon function for breakpoint organizer delegates.Common function for views related to debugging.Common function for launch configuration tabs.Common function for launch configuration tab groups.Default implementation for a breakpoint type category.Launch configuration tab used to specify the location a launch configuration is stored in, whether it should appear in the favorites list, and perspective switching behavior for an associated launch.Deprecated.A
PopupDialogthat is automatically positioned relative to a specified anchor point.This class provides utilities for clients of the debug UI.Deprecated.deferred custom content in the debug views is no longer supported by
IDeferredWorkbenchAdapter.Launch configuration tab for configuring the environment passed into Runtime.exec(...) when a config is launched.A breakpoint organizer is used to categorize breakpoints and provides change notification when categorization has changed.Optional enhancements to the
IBreakpointOrganizerDelegateinterface.Represents a breakpoint's type to support organization of breakpoints by type in the breakpoints view.A debug model presentation may implement this interface to override standard editor positioning and annotations associated with source code display for stack frames.A debug model presentation is responsible for providing labels, images, and editors associated with debug elements in a specific debug model.Optional extension for an
IDebugModelPresentation.Constant definitions for debug UI plug-in.Common function for debug views.A detail pane is created from a detail pane factory and displays detailed information about a current selection with an SWT
Control.An extension to the detail pane interface which allows implementors to provide a selection provider instead of setting the selection provider of the view's
sitedirectly.An extension to the detail pane interface which allows implementors to save contents of the details pane.A detail pane factory creates one or more types of detail panes.A debug model presentation may implement this interface to override standard annotations used to display instruction pointers for stack frames.A launch configuration dialog is used to edit and launch launch configurations.A launch configuration tab is used to edit/view attributes of a specific type of launch configuration.Optional enhancements for
ILaunchConfigurationTab.A launch configuration tab group is used to edit/view attributes of a specific type of launch configuration.A launch group identifies a group of launch configurations by a launch mode and category.A launch shortcut is capable of launching a selection or active editor in the workbench.An extension to a standard launch shortcut (
ILaunchShortcut) allowing launch shortcuts to specify how selections and editors should be launched.A
DebugPopupthat can be used to inspect an
IExpressionobject.A source presentation is used to resolve an editor in which to display a debug model element, breakpoint, or source element.Notified of detailed value descriptions.Decorator for
ILaunchConfigurationprototypes.Launch configuration tab used to specify the prototype associated with a launch configuration, and also listed attributes from prototype shared with the launch configuration.A launch configuration tab which allows the user to specify which resources should be refreshed when the launch terminates.A dialog that prompts the user to choose and configure a string substitution variable.Base class for custom variable filters.A control for setting the working directory associated with a launch configuration.