Tapahtumat

org.eclipse.ui.activities

3.0

Org.eclipse.ui.activities-laajennuspisteen avulla voidaan määrittää toimintoja ja liittyviä elementtejä. Toimintojen avulla käyttöympäristö voi suodattaa tietyt lisäosalisäykset käyttäjien näkymästä siihen asti, kunnes käyttäjän toiminta osoittaa, että käyttäjä haluaisi käyttää niitä. Tällä tavalla Eclipse-ympäristö voi kasvaa dynaamisesti käyttäjän käyttötapojen mukaisesti.

<!ELEMENT extension (activity , activityRequirementBinding , activityPatternBinding , category , categoryActivityBinding , defaultEnablement)*>

<!ATTLIST extension

id    CDATA #IMPLIED

name  CDATA #IMPLIED

point CDATA #REQUIRED>


<!ELEMENT activity EMPTY>

<!ATTLIST activity

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Tämän elementin avulla määritetään toiminnot. Jos samalle tunnukselle (id-määrite) on määritetty useita tällaisia elementtejä, käytetään vain viimeisintä määritettyä elementtiä (siinä järjestyksessä kuin ne luetaan rekisteristä).



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Tämän elementin avulla toimintoja voidaan sitoa toisiinsa. Määritetty suhde toimii niin, että jos activityId-määritteen mukainen toiminto otetaan joskus käyttöön, myös requiredActivityId-määritteen mukainen toiminto otetaan käyttöön.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Tämän elementin avulla toimintoja voidaan sitoa kaavoihin.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Tämän elementin avulla määritetään luokat. Jos samalle tunnukselle (id-määrite) on määritetty useita tällaisia elementtejä, käytetään vain viimeisintä määritettyä elementtiä (siinä järjestyksessä kuin ne luetaan rekisteristä).



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Tämän elementin avulla voidaan sitoa luokkia toimintoihin.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Tämän elementin avulla voidaan määrittää, onko toiminto oletusarvoisesti käytettävissä.



Seuraavassa on esimerkki usean toiminnon ja luokan sekä niiden sidontojen määrityksestä.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"Com.xyz-lisäosan lisäysten suodatus"

name=

"Oma toiminto"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"Toisten com.xyz-lisäosan lisäysten suodatus"

name=

"Toinen oma toiminto"

/>

<!-- toinen toiminto edellyttää toista toimintoa -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"com.xyz Activities"

name=

"Oma luokka"

/>

<!-- toiminto sijoitetaan luokkaan -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- kaikki com.xyz-lisäosan lisäykset sidotaan -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- com.xyz.other-lisäosan my.contribution-lisäys sidotaan -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

"com\.xyz\.other/my.contribution"

/>

<!-- toiminto on oletusarvon mukaan käytettävissä -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

Tässä versiossa ei ole mitään muuta julkista API-liittymää toimintojen tai liitettyjen elementtien määritykseen kuin tämä laajennuspiste. Toimintojen tilan työympäristössä voi tarkistaa org.eclipse.ui.IWorkbench.getActivitySupport()-liittymällä. Sen avulla voi tehdä kyselyjä käytössä olevista toiminnoista ja päivittää niitä.

Työympäristö ei sisällä mitään oletustoimintoja. Toiminnot on tarkoitettu määritettäväksi tuotetasolla, kuten Eclipse SDK -tuotteessa. Näin voidaan yhdistää tiiviisti kaikki (tunnetut) komponentit, jotka tuote sisältää.