Marker Navigation Providers Extension Point

org.eclipse.gmf.runtime.common.ui.services.markerNavigationProviders

This extension point facilitates the configuration of providers for the marker navigation service (org.eclipse.gmf.runtime.common.ui.services.marker.MarkerNavigationService).

The marker navigation service enables Xtools clients to perform the navigation feedback when the user double clicks on or "goes to" a marker reference. The attribute values defined on the marker identify a location or locations in the resource that are of interest to the user. The feedback associated with navigation to that location depends upon the resource and its associated editors. The feedback might simply be selecting the appropriate object(s) specified by the marker's location or the feedback could involve a separate dialog to describe the reason for the marker (e.g., errors).

In order to make use of the marker navigation service, an Xtools client should define its own marker types and creates the marker instances on the appropriate resources. Markers created on the workspace root are not navigable.

<!ELEMENT extension (MarkerNavigationProvider)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT MarkerNavigationProvider (Priority , MarkerType+ , Policy?)>

<!ATTLIST MarkerNavigationProvider

class CDATA #REQUIRED>


<!ELEMENT Priority EMPTY>

<!ATTLIST Priority

name (Lowest|Low|Medium|High|Highest) >


<!ELEMENT MarkerType EMPTY>

<!ATTLIST MarkerType

name CDATA #REQUIRED>


<!ELEMENT Policy EMPTY>

<!ATTLIST Policy

class CDATA #REQUIRED>


Following is an example of a marker navigation provider extension:

   

<extension id=

"markerNavigationProviders"

name=

"%ext.markerNavigationProviders"

point=

"org.eclipse.gmf.runtime.common.ui.services.markerNavigationProviders"

>

<MarkerNavigationProvider class=

"org.eclipse.test.project.ui.providers.ModelerMarkerNavigationProvider"

>

<Priority name=

"Highest"

>

</Priority>

<MarkerType name=

"org.eclipse.test.bookmark"

>

</MarkerType>

</MarkerNavigationProvider>

</extension>

The value of the class attribute must represent a subclass of org.eclipse.gmf.runtime.common.core.service.AbstractProvider that implements org.eclipse.gmf.runtime.common.ui.services.marker.IMarkerNavigationProvider.