說明內容產生器

org.eclipse.help.contentProducer

3.0 版

為了提供動態(在執行時期產生)說明內容。內容生產器依每一個外掛程式來登錄,且只在外掛程式範圍內有效。為了在另一個外掛程式中重複使用內容生產器,應該使用 binding 元素。這項策略可防止外掛程式把持所有外掛程式的內容生產。連結至內容生產器,外掛程式可授權在准許的外掛程式中控制所有文件的內容生產。

<!ELEMENT extension (contentProducer | binding)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentProducer (producer)>

<!ATTLIST contentProducer

producer CDATA #IMPLIED>


<!ELEMENT producer (parameter*)>

<!ATTLIST producer

class CDATA #REQUIRED>


<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>


<!ELEMENT binding EMPTY>

<!ATTLIST binding

producerId CDATA #REQUIRED>


下列是內容生產器延伸點的使用範例:

  

<extension point=

"org.eclipse.help.contentProducer"

id=

"org.eclipse.myPlugin.myDynamicHelpProducer"

name=

"My Dynamic Help Content"

>

<contentProducer producer=

"org.eclipse.myPlugin.myPackage.Myproducer"

/>

</extension>

提供的內容產生器類別必須實作 org.eclipse.help.IHelpContentProducer 介面。產生器負責提供內容給外掛程式中的動態說明資源。從外掛程式取得每個說明資源的說明,都會呼叫內容產生器的方法。

無。如果文件外掛程式未提供說明內容產生器或結果產生空值的呼叫,說明系統會搜尋 doc.zip 以及在外掛程式安裝位置的檔案系統,以尋找靜態文件並顯示其內容。