検索参加者は、拡張子が表示されるプラグインと関連付けされています。参加者を別のプラグインで再利用するために、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
を使用して、この参加者へバインディングする必要があります。
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