Breakpoint Organizers

Identifier:
org.eclipse.debug.ui.breakpointOrganizers

Since:
3.1

Description:
Breakpoint organizers categorize breakpoints based on some specific criteria. For example, a breakpoint organizer is provided to categorize breakpoints by project. Organizers with the specified name will be automatically created by the Debug Platform and presented to the user as options for grouping breakpoints. The supplied class, which must implement org.eclipse.debug.ui.IBreakpointOrganizerDelegate, will be loaded only as necessary, to avoid early plugin activation.

Configuration Markup:

<!ELEMENT extension (breakpointOrganizer+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT breakpointOrganizer EMPTY>

<!ATTLIST breakpointOrganizer

id          CDATA #REQUIRED

class       CDATA #REQUIRED

label       CDATA #REQUIRED

icon        CDATA #IMPLIED

othersLabel CDATA #IMPLIED>


Examples:
Following is an example of a breakpoint organizer extension.

<extension
    point="org.eclipse.debug.ui.breakpointOrganizers">
    <breakpointOrganizer
    class="com.example.BreakpointOrganizer"
     id="com.example.BreakpointOrganizer"
     label="Example Organizer"
     icon="icons/full/obj16/example_org.png"/>
</extension>
In the above example, the supplied factory will be included in the list of options for grouping breakpoints ("Group By > Example Organizer"). When selected, the associated organizer will be used to categorize breakpoints.

API Information:
Value of the attribute class must be a fully qualified name of a Java class that implements the interface org.eclipse.debug.ui.IBreakpointOrganizerDelegate. Since 3.3 the class may optionally implement org.eclipse.debug.ui.IBreakpointOrganizerDelegateExtension.

Supplied Implementation:
The Debug Platform provides breakpoint organizers for projects, files, breakpoint types, and working sets.


Copyright (c) 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html