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