资源标记

标识:org.eclipse.core.resources.markers

描述:工作区支持任意资源上的标记的概念。标记是一种元数据(类似于属性),它可以用来使用用户信息来标记资源。每当工作区保存或快照完成时,可选择是否由工作区持久化标记。

用户可以定义和查询给定类型的标记。标记类型是在支持多重继承的层次结构中定义的。标记类型定义还指定必须或可能存在于该类型的标记上的一些属性以及该类型的标记是否应该被持久化。

标记扩展点允许标记编写者使用符号名注册他们的标记类型,然后,在工作区中使用此符号名来创建和查询标记。该符号名是标记扩展的标识。当定义标记扩展时,鼓励用户在“name”属性中包含人们可阅读的值, “name”属性标识它们的标记,并且可能显示给用户。

配置标记:

   <!ELEMENT extension (super* , persistent? , attribute*)>

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

   <!ELEMENT super EMPTY>

   <!ATTLIST super
     type CDATA #REQUIRED
   >

   <!ELEMENT persistent EMPTY>

   <!ATTLIST persistent
     value (true | false)
   >

   <!ELEMENT attribute EMPTY>

   <!ATTLIST attribute
     name CDATA #REQUIRED
   >

示例:以下是构建器配置的示例:

   <extension id="com.xyz.coolMarker" point="org.eclipse.core.resources.markers" name="Cool Marker">
      <persistent value="true"/>
      <super type="org.eclipse.core.resources.problemmarker"/>
      <super type="org.eclipse.core.resources.textmarker"/>
      <attribute name="owner"/>
   </extension>

API 信息:所有标记(不管它们是哪种类型)都是 org.eclipse.core.resources.IMarker 的实例。

所提供的实现:平台本身具有许多预先定义的标记类型。必要时,特定产品安装可能包含附加标记。

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