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.
Interface Summary Interface Description IBreakpointOrganizerDelegateA breakpoint organizer is used to categorize breakpoints and provides change notification when categorization has changed. IBreakpointOrganizerDelegateExtensionOptional enhancements to the
IBreakpointTypeCategoryRepresents a breakpoint's type to support organization of breakpoints by type in the breakpoints view. IDebugEditorPresentationA debug model presentation may implement this interface to override standard editor positioning and annotations associated with source code display for stack frames. IDebugModelPresentationA debug model presentation is responsible for providing labels, images, and editors associated with debug elements in a specific debug model. IDebugModelPresentationExtensionOptional extension for an
IDebugUIConstantsConstant definitions for debug UI plug-in. IDebugViewCommon function for debug views. IDetailPaneA detail pane is created from a detail pane factory and displays detailed information about a current selection with an SWT
IDetailPane2An extension to the detail pane interface which allows implementors to provide a selection provider instead of setting the selection provider of the view's
IDetailPane3An extension to the detail pane interface which allows implementors to save contents of the details pane. IDetailPaneFactoryA detail pane factory creates one or more types of detail panes. IInstructionPointerPresentationA debug model presentation may implement this interface to override standard annotations used to display instruction pointers for stack frames. ILaunchConfigurationDialogA launch configuration dialog is used to edit and launch launch configurations. ILaunchConfigurationTabA launch configuration tab is used to edit/view attributes of a specific type of launch configuration. ILaunchConfigurationTab2Optional enhancements for
ILaunchConfigurationTabGroupA launch configuration tab group is used to edit/view attributes of a specific type of launch configuration. ILaunchGroupA launch group identifies a group of launch configurations by a launch mode and category. ILaunchShortcutA launch shortcut is capable of launching a selection or active editor in the workbench. ILaunchShortcut2An extension to a standard launch shortcut (
ILaunchShortcut) allowing launch shortcuts to specify how selections and editors should be launched.
ISourcePresentationA source presentation is used to resolve an editor in which to display a debug model element, breakpoint, or source element. IValueDetailListenerNotified of detailed value descriptions.
Class Summary Class Description AbstractBreakpointOrganizerDelegateCommon function for breakpoint organizer delegates. AbstractDebugViewCommon function for views related to debugging. AbstractLaunchConfigurationTabCommon function for launch configuration tabs. AbstractLaunchConfigurationTabGroupCommon function for launch configuration tab groups. BreakpointTypeCategoryDefault implementation for a breakpoint type category. CommonTabLaunch 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. DebugElementWorkbenchAdapter Deprecated.Custom content in the debug views is no longer supported by
PopupDialogthat is automatically positioned relative to a specified anchor point.
DebugUIToolsThis class provides utilities for clients of the debug UI. DeferredDebugElementWorkbenchAdapter Deprecated.deferred custom content in the debug views is no longer supported by
EnvironmentTabLaunch configuration tab for configuring the environment passed into Runtime.exec(...) when a config is launched. InspectPopupDialogA
DebugPopupthat can be used to inspect an
PrototypeTabLaunch configuration tab used to specify the prototype associated with a launch configuration, and also listed attributes from prototype shared with the launch configuration. RefreshTabA launch configuration tab which allows the user to specify which resources should be refreshed when the launch terminates. StringVariableSelectionDialogA dialog that prompts the user to choose and configure a string substitution variable. StringVariableSelectionDialog.VariableFilterBase class for custom variable filters. WorkingDirectoryBlockA control for setting the working directory associated with a launch configuration.