Properties Providers Extension Point

org.eclipse.gmf.runtime.common.ui.services.properties.propertiesProviders

This extension point facilitates the configuration of providers for the properties service (org.eclipse.gmf.runtime.common.ui.services.properties.PropertiesService). Using this extension point, providers are registered to contribute properties to the Eclipse property sheet view part, given a workbench selection.

<!ELEMENT extension (PropertiesProvider)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT PropertiesProvider (Priority)>

<!ATTLIST PropertiesProvider

class              CDATA #REQUIRED

verifyPluginLoaded (true | false) >

A property provider element describes a client defined property provider object.



<!ELEMENT Priority EMPTY>

<!ATTLIST Priority

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

Priority element specifies the priority of the provider from HIGHEST to LOWEST. The providers will be allowed to contribute to the property source in order of their priorities - from HIGHEST to LOWEST. This will ensure the desired order of contribution and helps to exclude duplicate properties, already contributed by others. For example, a provider with LOWEST priority, when executed, can check if there are any properties already contributed by any other providers. If none - it may want to contribute, if some - may want to withraw from contribution.



The following is an example of a provider extension:
 

<extension id=

"myPropertiesProvider"

name=

"My Properties Provider Name"

point=

"org.eclipse.gmf.runtime.common.ui.services.properties.propertiesProviders"

>

<PropertiesProvider verifyPluginLoaded=

"false"

class=

"com.examples.MyPropertiesProvider"

>

<Priority name=

"Medium"

>

</Priority>

</PropertiesProvider>

</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.properties.IPropertiesProvider