Supporto attivitā

org.eclipse.ui.activitySupport

3.1

Questo punto di estensione viene utilizzato per registrare estensioni di supporto diverse, relative all'infrastruttura delle attivitā.

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

Specifica un punto di trigger. Un punto di trigger č un identificativo utilizzato dal motore attivitā per determinare se un'azione deve causare l'abilitazione delle attivitā.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Un suggerimento (hint) rappresenta dei dati che possono essere utilizzati dall'infrastruttura Eclipse per determinare il comportamento del supporto attivitā in relazione al punto di trigger che lo contiene.

I seguenti suggerimenti sono noti e ci si aspetta che gli advisor dei punti di trigger li riconoscano:

interactive
Indica se questo punto di trigger viene gestito in modo "interattivo". Ovvero, č il risultato esplicito di un'azione dell'utente, ad esempio l'attivazione di una procedura guidata nella finestra di dialogo della procedura guidata. I valori ammessi sono true e false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Un advisor del punto di trigger č un meccanismo basato su criteri che viene consultato quando il sistema intraprende un'azione alla quale sono associate attivitā disabilitate. Č responsabilitā degli advisor stabilire se proseguire l'azione e, se č possibile proseguire, quali attivitā devono essere abilitate.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Specifica un collegamento tra un prodotto e un advisor. Questi collegamenti determinano quale advisor č appropriato per il prodotto corrente (come definito da org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Questo elemento consente di collegare le icone alle categorie. Queste icone possono essere utilizzate dai componenti di interfaccia utente che richiedono di visualizzare le categorie.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Questo elemento consente di collegare le icone alle attivitā. Queste icone possono essere utilizzate dai componenti di interfaccia utente che richiedono di visualizzare le attivitā.



Di seguito viene riportato un esempio di punto di trigger non interattivo:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Di seguito viene riportato un esempio di advisor del punto di trigger collegato ad un particolare prodotto:

  

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

Di seguito viene riportato un esempio di collegamento di immagini ad attivitā e categorie:

  

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

Il valore dell'attributo class del tag triggerPointAdvisor deve essere il nome completo di una classe che implementa org.eclipse.ui.activities.ITriggerPointAdvisor.

L'implementazione del workbench (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) č disponibile per le sottoclassi e il riutilizzo da parte dei client.