資源標示元

識別碼:org.eclipse.core.resources.markers

說明:工作區支援在任意資源上的標示元的觀念。 標示元是一種 Meta 資料(類似內容),可用來以使用者資訊標示資源。 每當儲存工作區或進行瞬間快照時,工作區會(選用)持續標示元。

使用者可以定義和查詢給定類型的標示元。 標示元類型定義在支援多重繼承的階層中。 標示元類型定義也會指定一些必須或可以出現在該類型標示元上的屬性, 以及應不應該持續該類型的標示元。

標示元延伸點可讓標示元作者將他們的標示元類型登錄在某符號名稱之下,再從工作區中,利用這個符號名稱來建立和查詢標示元。 符號名稱是標示元延伸項的 ID。 當定義標示元延伸項目時,使用者最好在用來識別其標示元且使用者可能會見到的 "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) 2002 IBM Corporation and others. All rights reserved. 這個程式和伴隨的素材可以根據伴隨這個分送,而且可在 http://www.eclipse.org/legal/cpl-v10.html 中取得的 Common Public License v1.0 的條款來使用