提供標示元說明

現在我們準備好要看一下如何新增說明至 Readme 工具的標示元。使用 org.eclipse.ui.markerHelp 延伸點完成新增標示元說明。延伸點讓外掛程式建立說明環境定義 ID 與標示元特定類型的關聯性。標示元僅限於利用標示元類型才會完整,或利用一或多個屬性的值才會更加完整。Readme 工具宣告一些不同的說明環境定義:

<extension point="org.eclipse.ui.markerHelp"> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example1_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.id" value= "1234"/> 
   </markerHelp> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example2_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> 
   </markerHelp> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example3_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> 
      <attribute name="org.eclipse.ui.examples.readmetool.department" value= "infra"/> 
   </markerHelp> 
   ...

每一個標示元說明環境定義為 Readme 標示元類型所定義。然而,每一個說明環境定義關聯於不同的屬性值組合。第一個標示元說明環境定義為標示元 ID 屬性設為 "1234" 所使用。說明環境定義定義在外掛程式的 HelpContexts.xml 檔中:

<context id="marker_example1_context" >
	<description>Readme marker example 1 <b>Help</b> id = 1234 </description>
</context>

非常確定的,當我們選取 Readme 標示元 id="1234" 並使用 F1 選取說明時,會看到說明敘述。

作業清單和標示元說明

Copyright IBM Corporation and others 2000, 2003.