标记帮助

标识:org.eclipse.ui.markerHelp

起始发行版:发行版 2.0

描述:此扩展点用来将帮助上下文标识与特定“种类”的标记(具有某些类型或具有某些属性值的标记)相关联。

配置标记:

   <!ELEMENT extension (markerHelp*)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

   <!ELEMENT markerHelp (attribute*)>

   <!ATTLIST markerHelp
     markerType    CDATA #IMPLIED
     helpContextId CDATA #REQUIRED
   >

   <!ELEMENT attribute EMPTY>

   <!ATTLIST attribute
     name  CDATA #REQUIRED
     value CDATA #REQUIRED
   >

示例:以下是标记帮助扩展的一个示例(请注意子元素和使用属性的方法):

 <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>
   </extension> 

在上面的示例中,帮助上下文标识与类型为 org.eclipse.ui.examples.readmetool.readmemarker 的标记相关联,该标记的 org.eclipse.ui.examples.readmetool.id 属性的值为 1234。

API 信息:开发者应确保为给定的标记只提供单个帮助上下文标识。如果为给定种类的标记提供了两个或多个帮助上下文标识,则工作台不会定义将返回哪个帮助上下文标识。但是,工作台确实定义了将始终为给定标记返回“最特定”的上下文标记。即,与三个相匹配属性值相关联的上下文标识将在只与两个相匹配属性值相关联的上下文标识之前返回。

Copyright (c) 2002, 2003 IBM Corporation and others. 该程序及附带提供的资料是基于“一般公共许可证”(Common Public License) v1.0 的条款提供的,本发行版中提供了该许可证条款,并且也可 在以下位置处找到该条款:http://www.eclipse.org/legal/cpl-v10.htm