搜尋參與者和顯示延伸規格的外掛程式有關聯。為了在其他外掛程式中重複使用參與者,請利用 binding
來參照參與者。這種策略可防止外掛程式在整個產品上強制以參與者來處理已登錄的副檔名。只要加入明確的參照,外掛程式可表示允許被參照的搜尋參與者處理這些副檔名的文件檢索。至於不是 TOC 中的文件,則沒有這種危險。因此,文件為廣域範圍,不需要使用 binding
。
<!ELEMENT extension (searchParticipant | binding)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT searchParticipant (participant?)>
<!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
做為目標參與者 id。
Copyright (c) 2005, 2006 IBM Corporation and others.
All
rights reserved. 本程式與隨附的資料依照 Elipse Public License 1.0 版此次發行所隨附的條款而提供,
可以在以下網址取得:http://www.eclipse.org/legal/epl-v10.html