Aktiviteter

org.eclipse.ui.activities

3.0

Utvidelsespunktet org.eclipse.ui.activities blir brukt til å deklarere aktiviteter og tilknyttede elementer. Plattformen bruker aktiviteter til å filtrere bort bestemte plugin-bidrag fra brukerens visning helt til de uttrykker interesse for dem. Dette gjør at Eclipse kan vokse dynamisk basert på bruksmønsteret til brukeren.

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

Dette elementet blir brukt til å definere aktiviteter. Hvis det er flere slike elementer med samme id-attributt, er det bare elementet som sist ble deklarert (i rekkefølgen registeret leses) som anses som gyldig.



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Dette elementet gjør det mulig å binde aktiviteter til aktiviteter. Forholdet er slik at hvis activityId blir aktivert, så blir også requiredActivityId aktivert.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Dette elementet gjør det mulig å binde aktiviteter til mønstre.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Dette elementet blir brukt til å definere kategorier. Hvis det er flere slike elementer med samme id-attributt, er det bare elementet som sist ble deklarert (i rekkefølgen registeret leses) som anses som gyldig.



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Dette elementet gjør det mulig å binde kategorier til aktiviteter.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Dette elementet gjør det mulig å oppgi at en gitt aktivitet som standard skal aktiveres.



Nedenfor finner du et eksempel på flere aktiviteter og kategoridefinisjoner, i tillegg til tilknyttede bindinger.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"Filters contributions from com.xyz"

name=

"My Activity"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"Filters other contributions from com.xyz"

name=

"My Other Activity"

/>

<!-- other activity requires activity -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"com.xyz Activities"

name=

"My Category"

/>

<!-- put the activity in the category -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- bind all contributions from plugin com.xyz -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- bind my.contribution from plugin com.xyz.other -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

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

/>

<!-- our activity should be enabled by default -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

Det er for øyeblikket ikke noen felles API for deklarering av aktiviteter eller tilknyttede elementer, annet enn dette utvidelsespunktet. Du kan få tilgang til tilstanden til aktivitetene på arbeidsbenken via org.eclipse.ui.IWorkbench.getActivitySupport(). Herfra kan du utføre en spørring etter og oppdatere settet med aktiviteter som for øyeblikket er aktivert.

Arbeidsbenken har ingen "standardaktiviteter". Aktivitetene skal defineres på produktnivå, for eksempel Eclipse SDK, for at alle (kjente) komponenter som produktet inneholder, skal integreres tett.