Activiteitenondersteuning

org.eclipse.ui.activitySupport

3.1

Dit extensiepunt wordt gebruikt voor het registreren van verschillende ondersteuningsextensies die te maken hebben met de infrastructuur voor de activiteiten.

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

Hiermee wordt een triggerpunt opgegeven. Een triggerpunt is een identificatie die wordt gebruikt door de activiteitenengine om vast te stellen of een bepaalde actie het inschakelen van activiteiten tot gevolg moet hebben.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Een hint bestaat uit een aantal gegevens die kunnen worden gebruikt door de Eclipse-infrastructuur om het gedrag vast te stellen van de activiteitenondersteuning in verband met het beschikbaar gestelde triggerpunt.

De volgende hints zijn "algemeen bekend" en worden dus erkend door de triggerpunt-adviseurs:

interactive
Bepaalt of dit triggerpunt een hint is op een "interactieve" manier. Dit betekent dat dit het expliciete resultaat is van een actie die is ondernomen door de gebruiker, bijvoorbeeld het activeren van een wizard in het wizarddialoogvenster. Geaccepteerde waarden zijn true en false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Een triggerpunt-adviseur is een beleidsmechanisme dat geraadpleegd wordt wanneer het systeem een actie onderneemt waar uitgeschakelde activiteiten bij horen. De taak van de adviseur is het beantwoorden van de vraag of een actie moet worden voortgezet en of, als dit kan, welke activiteiten moeten worden ingeschakeld.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Geeft een binding op tussen een product en een adviseur. Door deze bindings wordt bepaald welke adviseur geschikt is voor het huidige product (gedefinieerd door org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Dit element zorgt voor de binding tussen pictogrammen en categorieën. Deze pictogrammen kunnen worden gebruikt door de gebruikersinterfacecomponenten wanneer de categorieën op een bepaalde manier moeten worden gevisualiseerd.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Dit element zorgt voor de binding van pictogrammen aan activiteiten. Deze pictogrammen kunnen worden gebruikt door gebruikersinterface-componenten voor het visualiseren van activiteiten.



Dit is een voorbeeld van een niet-actief triggerpunt:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Dit is een voorbeeld van een triggerpunt-adviseur die aan een bepaald product is gekoppeld:

  

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

Dit is een voorbeeld van het koppelen van afbeeldingen aan activiteiten en categorieën:

  

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

De waarde van het kenmerk class van de tag triggerPointAdvisor moet de volledig gekwalificeerde naam zijn van een klasse die org.eclipse.ui.activities.ITriggerPointAdvisor implementeert.

De workbenchimplementatie (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) is beschikbaar voor clients om subklassen te maken en voor hergebruik.