Aktiviteter

org.eclipse.ui.activities

3.0

Utökningspunkten org.eclipse.ui.activities används för att deklarera aktiviteter och associerade element. Aktiviteter används på plattformen för att filtrera vissa insticksprograms innehåll från användarvyn tills det tillfälle användaren uttrycker intresse för dem. På så sätt kan Eclipse växa dynamiskt baserat på en användares användningsmönster.

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

Det här elementet används för att definiera aktiviteter. Om det finns fler av dessa element med samma id-attribut är det endast det senast deklarerade elementet (i läsordning av registret) som betraktas som giltigt.



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Med hjälp av det här elementet kan du binda aktiviteter till aktiviteter. Förhållande är så att om activityId vid något tillfälle aktiveras, då aktiveras även requiredActivityId.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Med det här elementet kan du binda aktiviteter till mönster.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Det här elementet används för att definiera kategorier. Om det finns fler av dessa element med samma id-attribut är det endast det senast deklarerade elementet (i läsordning av registret) som betraktas som giltigt.



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Med hjälp av det här elementet kan du binda kategorier till aktiviteter.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Med det här elementet kan du ange att en viss aktivitet ska aktiveras som standard.



Här följer ett exempel på flera aktivitets- och kategoridefinitioner samt associerade bindningar.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"Filterinnehåll från com.xyz"

name=

"Min aktivitet"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"Filter och annat innehåll från com.xyz"

name=

"Min andra aktivitet"

/>

<!-- annan aktivitet fordrar aktivitet -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"com.xyz Activities"

name=

"Min kategori"

/>

<!-- placera aktiviteten i kategorin -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- bind allt innehåll från insticksprogram com.xyz -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- bind my.contribution från insticksprogram com.xyz.other -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

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

/>

<!-- vår aktivitet måste vara aktiverad som standard -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

Det finns för närvarande inget publikt API för att deklarerar aktiviteter eller associerade element utöver dem här utökningspunkten. Läget för aktiviteter i arbetsmiljön är åtkomliga via org.eclipse.ui.IWorkbench.getActivitySupport(). Härifrån kan du efterfråga och uppdatera uppsättningen med för tillfället aktiverade aktiviteter.

Inga "standardaktiviteter" tillhandahålls i arbetsmiljön. Aktiviteter är avsedda att definieras på produktnivå, så som Eclipse SDK, så att nära integrering sker av alla de (kända) komponenter som produkten innehåller.