Aktiviteter

org.eclipse.ui.activities

3.0

Udvidelsespunktet org.eclipse.ui.activities bruges til at erklære aktiviteter og tilhørende elementer. Platformen bruger aktiviteter til at filtrere visse plugin-leveringer fra brugernes oversigt, indtil de udtrykker interesse for dem. Det gør det muligt for Eclipse at vokse dynamisk på basis af brugerens brugsmønster.

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

<!ATTLIST-udvidelse

id    CDATA #IMPLIED

name  CDATA #IMPLIED

point CDATA #REQUIRED>


<!ELEMENT activity EMPTY>

<!ATTLIST activity

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Dette element bruges til at definere aktiviteter. Hvis der er flere af disse elementer med samme id-attribut, betragtes kun det sidst erklærede element (i læserækkefølgen for registreringsdatabasen) som gyldigt.



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Med dette element kan du binde aktiviteter til aktiviteter. Forholdet er sådan, at hvis activityId aktiveres, så aktiveres requiredActivityId også.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Med dette element kan du binde aktiviteter til mønstre.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Dette element bruges til at definere kategorier. Hvis der er flere af disse elementer med samme id-attribut, betragtes kun det sidst erklærede element (i læserækkefølgen for registreringsdatabasen) som gyldigt.



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Med dette element kan du binde kategorier til aktiviteter.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Med dette element kan du angive, at en given aktivitet skal aktiveres som standard.



Det følgende er et eksempel på flere aktivitets- og kategoridefinitioner samt de tilhørende bindinger.

 

<udvidelsespunkt=

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

Der er aktuelt ingen offentlig API til erklæring af aktiviteter eller tilhørende elementer bortset fra dette udvidelsespunkt. Tilstanden for aktiviteter på arbejdsbænken er tilgængelig via org.eclipse.ui.IWorkbench.getActivitySupport(). Herfra kan du afsende forespørgsler om og opdatere sættet af aktuelt aktiverede aktiviteter.

Arbejdsbænken leverer ingen "standardaktiviteter". Aktiviteter skal defineres på produktniveau, f.eks. Eclipse SDK, så alle de (kendte) komponenter, som produktet indeholder, integreres tæt.