內容類型

org.eclipse.core.runtime.contentTypes

3.0

內容類型延伸點可讓外掛程式提供內容類型型錄給平台。構成要素有兩種形式:內容類型檔案關聯

<!ELEMENT extension (content-type* , file-association*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT content-type (describer? , property*)>

<!ATTLIST content-type

id              CDATA #REQUIRED

base-type       CDATA #IMPLIED

name            CDATA #REQUIRED

file-extensions CDATA #IMPLIED

file-names      CDATA #IMPLIED

priority        (low|normal|high) "normal"

default-charset CDATA #IMPLIED

describer       CDATA #IMPLIED

alias-for       CDATA #IMPLIED>


<!ELEMENT describer (parameter*)>

<!ATTLIST describer

class  CDATA #REQUIRED

plugin CDATA #IMPLIED>

如果在 content-type 元素中使用描述子屬性,就會忽略這個元素。



<!ELEMENT file-association EMPTY>

<!ATTLIST file-association

content-type    CDATA #REQUIRED

file-names      CDATA #IMPLIED

file-extensions CDATA #IMPLIED>


<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>


<!ELEMENT property EMPTY>

<!ATTLIST property

name    CDATA #REQUIRED

default CDATA #IMPLIED>

宣告與這個內容類型相關的內容,並選擇性地指派預設值。請參閱 org.eclipse.core.runtime.content.IContentDescription,以取得內容的相關資訊。



以下是使用 org.eclipse.core.runtime.content.XMLRootElementContentDescriber 這個內建描述子之 XML 型內容類型宣告的範例:

   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<content-type id=

"ABC"

base-type=

"org.eclipse.core.runtime.xml"

file-extensions=

"a,b,c"

>

<describer class=

"org.eclipse.core.runtime.content.XMLRootElementContentDescriber"

>

<parameter name=

"element"

value=

"abc"

/>

</describer>

</content-type>

</extension>

以下是具有特定副檔名的簡單文字型內容類型的範例:

   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<content-type id=

"MyText"

base-type=

"org.eclipse.core.runtime.text"

file-extensions=

"mytxt"

/>

</extension>

如果需要將新的檔案名稱/副檔名關聯到現有的內容類型(相對於定義新的內容類型), 外掛程式可以依照下列方式來提出檔案關聯。這樣可以加強文字內容類型的定義,以併入遵循 "*.mytxt" 型樣的檔案名稱。

   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<file-association content-type=

"org.eclipse.core.runtime.text"

file-extensions=

"mytxt"

/>

</extension>

以下是用來定義內容的內容類型範例:
   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<content-type id=

"MyContentType"

file-extensions=

"dat"

>

<property name=

"file-format"

value=

"1"

/>

</content-type>

</extension>

describer 元素中的 class 屬性值必須代表 org.eclipse.core.runtime.content.IContentDescriberorg.eclipse.core.runtime.content.ITextContentDescriber 的實作。 org.eclipse.core.runtime.content API 傳回的 org.eclipse.core.runtime.content.IContentDescription 物件

org.eclipse.core.runtime 外掛程式提供下列內容類型:

平台中的其他外掛程式提供其他內容類型。

另外,org.eclipse.core.runtime 外掛程式也提供可以使用的內容說明子實作: