Sisältölajit

org.eclipse.core.runtime.contentTypes

3.0

Sisältölajien laajennuspisteen avulla lisäosilla voidaan tehdä lisäyksiä käyttöympäristön sisältölajiluetteloon. Lisäys voi olla joko sisältölajin tai tiedostoliitoksen lisäys.

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

Jos content-type-elementissä on describer-määrite, tämä elementti ohitetaan.



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

Tämä elementti määrittää tähän sisältölajiin liittyvän ominaisuuden, jolle voidaan myös haluttaessa määrittää oletusarvo. Lisätietoja ominaisuuksista on org.eclipse.core.runtime.content.IContentDescription-laajennuspisteen ohjeessa.



Seuraavassa on esimerkki XML-sisältölajin määrityksestä, jossa käytetään sisäistä org.eclipse.core.runtime.content.XMLRootElementContentDescriber-sisältökuvausta:

   

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

Seuraavassa on esimerkki tekstimuotoisesta sisältölajista, joka yhdistetään tiedostotunnisteeseen:

   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<content-type id=

"MyText"

base-type=

"org.eclipse.core.runtime.text"

file-extensions=

"mytxt"

/>

</extension>

Kun aiemmin määritetty sisältölaji halutaan yhdistää uusiin tiedostoihin tai tiedostotunnisteisiin (uuden sisältölajin määrityksen sijasta), lisäosa voidaan määrittää lisäämään tiedostoliitos seuraavan esimerkin mukaisesti. Esimerkissä tekstimuotoisen sisältölajin määritykseen lisätään tiedostot, joiden nimimuoto on *.mytxt.

   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<file-association content-type=

"org.eclipse.core.runtime.text"

file-extensions=

"mytxt"

/>

</extension>

Seuraavassa on esimerkki sisältölajin ominaisuuksien määrityksestä:
   

<extension point=

"org.eclipse.core.runtime.contentTypes"

>

<content-type id=

"MyContentType"

file-extensions=

"dat"

>

<property name=

"file-format"

value=

"1"

/>

</content-type>

</extension>

Describer-elementin (sisältökuvaustiedot) class-määritteen arvon on oltava org.eclipse.core.runtime.content.IContentDescriber- tai org.eclipse.core.runtime.content.ITextContentDescriber-liittymän toteuttava luokka. Org.eclipse.core.runtime.content-ohjelmointirajapinta palauttaa org.eclipse.core.runtime.content.IContentDescription-objekteja.

Org.eclipse.core.runtime-lisäosa sisältää seuraavat sisältölajit:

Muissa käyttöympäristön lisäosissa on muiden sisältölajien lisäyksiä.

Org.eclipse.core.runtime-lisäosa sisältää käyttövalmiita sisältökuvaustoteutuksia: