Soporte de actividades

org.eclipse.ui.activitySupport

3.1

Este punto de extensión se utiliza para registrar diversas extensiones de soporte relativas a la infraestructura de actividades.

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

Especifica un punto de desencadenante. Un punto desencadenante es un identificador utilizado por el motor de actividades para determinar si una acción debe causar o no la habilitación de actividades.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Una pista representa algunos datos que la infraestructura de Eclipse pueda utilizar para determinar el comportamiento del soporte de actividades relativo al punto desencadenante de alojamiento.

Las pistas siguientes son "conocidas" y se espera que los consejeros de puntos desencadenantes las reconozcan:

interactivo
Si este punto desencadenante es una pista de manera "interactiva. Es decir: es el resultado explícito de una acción emprendida por el usuario como, por ejemplo, activar un asistente en el diálogo de asistente. Los valores aceptados son true y false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Un consejero de punto desencadenante es un mecanismo de política que se consulta siempre que el sistema emprende una acción que tenga actividades asociadas que están inhabilitadas. Es responsabilidad de los consejeros responder si una acción debe continuar y, si puede hacerlo, cuáles son las actividades que se habilitarán.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Especifica un enlace entre un producto y un consejero. Estos enlaces determinan qué consejero es el adecuado para el producto actual (según lo definido por org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Este elemento permite el enlace de iconos a categorías. Estos iconos pueden utilizarse por componentes de la interfaz de usuario que quieran visualizar categorías de alguna manera.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Este elemento permite el enlace de iconos a actividades. Estos iconos pueden utilizarse por componentes de la interfaz de usuario que quieran visualizar categorías de alguna manera.



a continuación se muestra un ejemplo de punto desencadenante no interactivo:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

A continuación se muestra un ejemplo de consejero de punto desencadenante enlazado a un producto en particular:

  

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

A continuación se muestra un ejemplo de cómo enlazar imágenes a actividades y categorías:

  

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

el valor del atributo class del código triggerPointAdvisor debe ser el nombre totalmente calificado de una clase que implemente org.eclipse.ui.activities.ITriggerPointAdvisor.

La implementación del entorno de trabajo (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) está disponible para que los clientes puedan crear subclases y reutilizarla.