Aktivitetsstøtte

org.eclipse.ui.activitySupport

3.1

Dette utvidelsespunktet blir brukt til å registrere forskjellige støtteutvidelser knyttet til aktivitetsinfrastrukturen.

<!ELEMENT extension (triggerPoint | triggerPointAdvisor | triggerPointAdvisorProductBinding | categoryImageBinding | activityImageBinding)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT triggerPoint (hint*)>

<!ATTLIST triggerPoint

id CDATA #REQUIRED>

Oppgir et utløserpunkt. Et utløserpunkt er en ID som aktivitetsmotoren bruker til å bestemme om en handling skal føre til at aktiviteter aktiveres eller ikke.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Et tips representerer data som Eclipse-infrastrukturen kan bruke til å bestemme virkemåten til aktivitetsstøtten knyttet til vertsutløserpunktet.

Følgende tips er "velkjente", og det forventes av utløserpunktrådgivere godtar dem:

interactive
Om dette utløserpunktet er et tips på en "interaktiv" måte. Det vi si at det er et eksplisitt resultat av en handling som brukeren foretar seg, for eksempel aktivering av en veiviser i veiviserdialogboksen. Godtatte verdier er true og false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

En utløserpunktrådgiver er en policymekanisme som blir konsultert når systemet utfører en handling som har tilknyttede deaktiverte aktiviteter. Det er rådgiverens ansvar å svare på om handlingen skal fortsette, og hvis mulig, hvilke aktiviteter som skal aktiveres.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Oppgir en binding mellom et produkt og en rådgiver. Disse bindingene bestemmer hvilken rådgiver som passer til det gjeldende produktet (slik det er definert av org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Dette elementet gjør det mulig å binde ikoner til kategorier. Disse ikonene kan brukes av brukergrensesnittkomponentene som ønsker å visualisere kategoriene.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Dette elementet gjør det mulig å binde ikoner til aktiviteter. Disse ikonene kan brukes av brukergrensesnittkomponentene som ønsker å visualisere aktiviteter.



Nedenfor finner du et eksempel på et ikke-interaktivt utløserpunkt.

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Nedenfor finner du et eksempel på en utløserpunktrådgiver som er bundet til et bestemt produkt.

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPointAdvisor id=

"com.example.xyz.myTriggerPointAdvisor"

class=

"com.example.xyz.AdvisorImpl"

/>

<triggerPointAdvisorProductBinding productId=

"myProduct"

triggerPointAdvisorId=

"com.example.xyz.myTriggerPointAdvisor"

/>

</extension>

Nedenfor finner du et eksempel på hvordan du binder bilder til aktiviteter og kategorier.

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<activityImageBinding id=

"some.activity.id"

icon=

"icons/someIcon.gif"

/>

<categoryImageBinding id=

"some.category.id"

icon=

"icons/someIcon.gif"

/>

</extension>

Verdien av class-attributtet i koden triggerPointAdvisor må være det fullt kvalifiserte navnet på en klasse som implementerer org.eclipse.ui.activities.ITriggerPointAdvisor.

Arbeidsbenkimplementeringen (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) er tilgjengelig for klienter, slik at de kan opprette en subklasse av den og bruke den på nytt.