Marker Navigation Providers Extension Point

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

Description:
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.

Configuration Markup:

<!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>


Examples:
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> 


Copyright (c) 2003 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