| <?xml version='1.0' encoding='UTF-8'?> |
| <!-- Schema file written by PDE --> |
| <schema targetNamespace="org.eclipse.datatools.help"> |
| <annotation> |
| <appInfo> |
| <meta.schema plugin="org.eclipse.datatools.help" id="helpKeyProperties" name="Help Key Properties"/> |
| </appInfo> |
| <documentation> |
| This extension point supports the abstraction of help context IDs (and context-specific help search expressions for dynamic context-sensitive help) from the code in UI plug-ins. |
| <p>Context-sensitive help plug-ins, which declare contributions via the org.eclipse.help.contexts extension point, can also use this extension point to declare helpKey .properties files contributions. UI plug-ins that call the org.eclipse.datatools.help.ContextProviderDelegate method can use those helpKey .properties files to dynamically set help context IDs on widgets that adapt to IContextProvider.</p> |
| </documentation> |
| </annotation> |
| |
| <element name="extension"> |
| <complexType> |
| <sequence minOccurs="0" maxOccurs="unbounded"> |
| <element ref="contextIds"/> |
| <element ref="searchExpressions" minOccurs="0" maxOccurs="1"/> |
| </sequence> |
| <attribute name="point" type="string" use="required"> |
| <annotation> |
| <documentation> |
| |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="id" type="string"> |
| <annotation> |
| <documentation> |
| |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="name" type="string"> |
| <annotation> |
| <documentation> |
| |
| </documentation> |
| </annotation> |
| </attribute> |
| </complexType> |
| </element> |
| |
| <element name="contextIds"> |
| <annotation> |
| <documentation> |
| The &lt;contextIds&gt; element identifies a .properties file that defines help context IDs for a UI plug-in. |
| </documentation> |
| </annotation> |
| <complexType> |
| <attribute name="plugin" type="string" use="required"> |
| <annotation> |
| <documentation> |
| the UI plug-in for which a help context ID .properties file is contributed by a context-sensitive help plug-in. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="file" type="string" use="required"> |
| <annotation> |
| <documentation> |
| a help context ID .properties file contributed by a context-sensitive help plug-in. |
| </documentation> |
| </annotation> |
| </attribute> |
| </complexType> |
| </element> |
| |
| <element name="searchExpressions"> |
| <annotation> |
| <documentation> |
| The &lt;searchExpressions&gt; element identifies a .properties file that defines context-specific help search expressions for a UI plug-in. |
| </documentation> |
| </annotation> |
| <complexType> |
| <attribute name="plugin" type="string" use="required"> |
| <annotation> |
| <documentation> |
| the UI plug-in for which a help search expression .properties file is contributed by a context-sensitive help plug-in. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="file" type="string" use="required"> |
| <annotation> |
| <documentation> |
| a help search expression .properties file contributed by a context-sensitive help plug-in. |
| <p>For each UI plug-in that a particular context-sensitive help plug-in contributes .properties files, the &lt;contextIds&gt; and &lt;searchExpressions&gt; elements must be declared in the org.eclipse.datatools.help.helpKeyProperties extension.</p> |
| </documentation> |
| </annotation> |
| </attribute> |
| </complexType> |
| </element> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="since"/> |
| </appInfo> |
| <documentation> |
| DTP 1.5 |
| </documentation> |
| </annotation> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="examples"/> |
| </appInfo> |
| <documentation> |
| The following is an example of using the Help Key Properties extension point in the plug-in manifest (plugin.xml file) of a context-sensitive help plug-in: |
| <p> |
| <pre> |
| <extension point="org.eclipse.datatools.help.helpKeyProperties"> |
| <contextIds plugin="org.eclipse.datatools.connectivity.ui" |
| file="org.eclipse.datatools.connectivity.ui_contextIds.properties"/> |
| <searchExpressions plugin="org.eclipse.datatools.connectivity.ui" |
| file="org.eclipse.datatools.connectivity.ui_searchExpressions.properties"/> |
| </extension> |
| </pre> |
| </p> |
| </documentation> |
| </annotation> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="apiInfo"/> |
| </appInfo> |
| <documentation> |
| To take advantage of the help context ID abstraction, workbench parts must implement IContextProvider and call the org.eclipse.datatools.help.ContextProviderDelegate method. |
| </documentation> |
| </annotation> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="implementation"/> |
| </appInfo> |
| <documentation> |
| The default implementation of org.eclipse.datatools.help supports this extension point. |
| </documentation> |
| </annotation> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="copyright"/> |
| </appInfo> |
| <documentation> |
| Copyright (c) 2007 Sybase, Inc. |
| <br> |
| 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 <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a> |
| </documentation> |
| </annotation> |
| |
| </schema> |