Typy obsahu

org.eclipse.core.runtime.contentTypes

3.0

Bod rozšíření typů obsahu umožňuje modulům plug-in přispívat do katalogu typů obsahu platformy. Existují dvě formy příspěvků: typy obsahu a přiřazení souborů.

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

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


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

<!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>

Pokud je atribut popisovače použit v prvku content-type, tento prvek je ignorován.



<!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>

Deklaruje vlastnost související s tímto typem obsahu a volitelně přiřazuje výchozí hodnotu. Podrobnější informace o vlastnostech lze nalézt v org.eclipse.core.runtime.content.IContentDescription.



Zde je uveden příklad deklarace typu obsahu založené na XML s použitím vestavěného popisovače org.eclipse.core.runtime.content.XMLRootElementContentDescriber:

   

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

Zde je uveden příklad jednoduchého typu obsahu založeného na textu, který obsahuje konkrétní příponu souboru:

   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<content-type id=

"MyText"

base-type=

"org.eclipse.core.runtime.text"

file-extensions=

"mytxt"

/>

</extension>

Pokud je potřeba přidružit nové názvy souborů/přípony ke stávajícímu typu obsahu (namísto definování nového typu obsahu), je možné použít přiřazení souborů modulu plug-in, jak vidíte níže. Výsledkem je rozšíření definice textového typu obsahu zahrnujícího soubory s názvy podle vzoru "*.mytxt".

   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<file-association content-type=

"org.eclipse.core.runtime.text"

file-extensions=

"mytxt"

/>

</extension>

Níže je uveden příklad typu obsahu, který definuje vlastnosti:
   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<content-type id=

"MyContentType"

file-extensions=

"dat"

>

<property name=

"file-format"

value=

"1"

/>

</content-type>

</extension>

Hodnota atributu třídy v prvku popisovače musí představovat nástroj pro implementaci org.eclipse.core.runtime.content.IContentDescriber nebo org.eclipse.core.runtime.content.ITextContentDescriber. org.eclipse.core.runtime.content.IContentDescription objekty vracené rozhraním API org.eclipse.core.runtime.content

Modul plug-in org.eclipse.core.runtime poskytuje následující typy obsahu:

Ostatní moduly plug-in v platformě přispívají jinými typy obsahu.

Modul plug-in org.eclipse.core.runtime také poskytuje připravené implementace popisovačů obsahu: