标记帮助

org.eclipse.ui.ide.markerHelp

3.0(最初在发行版 2.0 中是作为 org.eclipse.ui.markerHelp 添加的)

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

<!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.ide.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。

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