搜索参与者与此扩展所在的插件相关联。要在其他插件中重复使用该参与者,应该使用 binding
来引用它们。此策略能够防止插件将其参与者强制用于它注册时所面向的文件扩展名的整个产品。通过添加显式引用,插件声明允许所引用的搜索参与者对具有那些扩展名的文档建立索引。对于 TOC 外部的文档来说,没有这样的危险。因此,它们是全局的,并且不应该使用 binding
。
<!ELEMENT extension (searchParticipant | binding)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT searchParticipant (participant?)>
<0!ATTLIST searchParticipant
id CDATA #REQUIRED
name CDATA #IMPLIED
icon CDATA #IMPLIED
participant CDATA #IMPLIED
extensions CDATA #IMPLIED
headless (true | false) "false">
extensions
属性时),此名称不是必需的。extensions
属性时),此图标不是必需的。org.eclipse.help.toc
扩展点中明确地使文件对帮助系统已知时,应该使用此属性。如果未指定此属性,则表示参与者自己对它所负责的所有文档建立索引。
另请注意,为已知文档注册的参与者具有插件作用域。如果要让某个参与者应用于另一插件中的文档,则必须使用
binding
元素来扩展作用域。相反,未指定此属性的参与者具有全局作用域。
false
。<!ELEMENT participant (parameter*)>
<!ATTLIST participant
class CDATA #IMPLIED>
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
<!ELEMENT binding EMPTY>
<!ATTLIST binding
participantId CDATA #IMPLIED>
searchParticipant
元素声明的搜索参与者的引用。可以通过进行绑定来复用插件中的参与者,而不会违反自顶向下策略。仅当对 TOC 中的文档建立索引时,才需要进行绑定。否则,参与者具有全局作用域。
<extension point=
"org.eclipse.help.base.luceneSearchParticipant"
>
<searchParticipant id=
"org.eclipse.myGlobalParticipant"
name=
"Global Participant"
icon=
"icons/mydoc.gif"
participant=
"org.eclipse.myPlugin.myPackage.MyGlobalParticipant"
headless=
"true"
/>
<searchParticipant id=
"org.eclipse.myXYZParticipant"
extensions=
"xyz"
participant=
"org.eclipse.myPlugin.myPackage.MyXYZParticipant"
/>
</extension>
binding
元素并将
org.eclipse.help.base.xhtml
用作目标参与者标识,从而与此参与者绑定。
Copyright (c) 2005, 2006 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