Interface IToggleBreakpointsTargetFactory

public interface IToggleBreakpointsTargetFactory

A toggle breakpoints target factory creates one or more toggle breakpoint
targets. The toggle breakpoints targets are used by toggle breakpoint actions
to create breakpoints appropriate for the active editor, debug session, project,
or selection.

Toggle breakpoints target factories are contributed via the
org.eclipse.debug.ui.toggleBreakpointsTargetFactories
extension point. Following is an example of a detail pane factory extension:

<extension point="org.eclipse.debug.ui.toggleBreakpointsTargetFactories">
<toggleTargetFactory
id="com.example.ExampleBreakpointToggleTargetFactory"
class="com.example.BreakpointToggleTargetFactory">
<enablement>
<!-- Test the active debug context. Enable only if the active context
is an element from "Example" debugger, or if there is no debug context
associated with the context element. Also enable if debug context is
empty -->
<with variable="debugContext">
<iterate>
<or>
<test property="org.eclipse.debug.ui.getModelIdentifier" value="com.example.model"/>
<test property="org.eclipse.debug.ui.getModelIdentifier" value=""/>
</or>
</iterate>
</with>
<!-- If there is no active debug context. Enable the breakpoint toggle for
the "Example" editors -->
<instanceof value="com.example.Editor"/>
</enablement>
</toggleTargetFactory>
</extension>

Clients contributing a toggle breakpoints target factory are intended to
implement this interface.

getToggleTargetName

Returns a human readable name for the breakpoint toggle target associated with the
given ID. Used to populate the context menu with meaningful names of the types of
breakpoints created by the given target.