Aktivitetsunderstøttelse

org.eclipse.ui.activitySupport

3.1

Dette udvidelsespunkt bruges til at registrere forskellige understøttelsesudvidelser, der relaterer til aktivitetsinfrastrukturen.

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

<!ATTLIST-udvidelse

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT triggerPoint (hint*)>

<!ATTLIST triggerPoint

id CDATA #REQUIRED>

Angiver et udløserpunkt. Et udløserpunkt er en id, der bruges af aktivitetsprogrammet til at bestemme, om en funktion skal kunne aktivere aktiviteter.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Et hint (tip) repræsenterer data, som Eclipse-infrastrukturen kan bruge til at bestemme funktionsmåden for den aktivitetsunderstøttelse, der relaterer til værtsudløserpunktet.

Følgende hints er "velkendte", og det forventes, at udløserpunktsrådgivere anerkender dem:

interactive
Hvorvidt udløserpunktet er hint på en "interaktiv" måde. Dvs. det er det eksplicitte resultat af en funktion, der er udført af brugeren, f.eks. aktivering af en guide i guidedialogboksen. Accepterede værdier er true og false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

En udløserpunktsrådgiver er en regelmekanisme, der konsulteres, når systemet udfører en funktion, der har deaktiverede aktiviteter tilknyttet. Det er rådgiverens ansvar at svare på, hvorvidt en funktion skal fortsætte, og hvis den skal, hvilke aktiviteter der skal aktiveres.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Angiver en binding mellem et produkt og en rådgiver. Disse bindinger bestemmer, hvilken rådgiver der passer til det aktuelle produkt (som defineret af org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Dette element gør det muligt at binde ikoner til kategorier. Disse ikoner kan benyttes af de brugergrænsefladekomponenter, der vil visualisere kategorier på en eller anden måde.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Med dette element kan du binde ikoner til aktiviteter. Disse ikoner kan benyttes af de brugergrænsefladekomponenter, der vil visualisere aktiviteter på en eller anden måde.



Det følgende er et eksempel på et ikke-interaktivt udløserpunkt:

  

<udvidelsespunkt=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Det følgende er et eksempel på en udløserpunktsrådgiver, der er bundet til et bestemt produkt:

  

<udvidelsespunkt=

"org.eclipse.ui.activitySupport"

>

<triggerPointAdvisor id=

"com.example.xyz.myTriggerPointAdvisor"

class=

"com.example.xyz.AdvisorImpl"

/>

<triggerPointAdvisorProductBinding productId=

"myProduct"

triggerPointAdvisorId=

"com.example.xyz.myTriggerPointAdvisor"

/>

</extension>

Det følgende er et eksempel på binding af billeder til aktiviteter og kategorier:

  

<udvidelsespunkt=

"org.eclipse.ui.activitySupport"

>

<activityImageBinding id=

"some.activity.id"

icon=

"icons/someIcon.gif"

/>

<categoryImageBinding id=

"some.category.id"

icon=

"icons/someIcon.gif"

/>

</extension>

Værdien for attributten class i triggerPointAdvisor-koden skal være det fuldstændige navn på en klasse, der implementerer org.eclipse.ui.activities.ITriggerPointAdvisor.

Arbejdsbænkimplementeringen org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) er tilgængelig for klienter til underklasser og genbrug.