Suporte de Actividades

org.eclipse.ui.activitySupport

3.1

Este ponto de extensão é utilizado para registar várias extensões relacionadas com a infra-estrutura 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 um ponto de activador. Um ponto de activação é um identificador que é utilizado pelo motor de actividades para determinar se uma acção deve ou não activar actividades.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Uma sugestão representa alguns dados que podem ser utilizados pela infra-estrutura Eclipse para determinar o comportamento do suporte de actividade relacionado com o ponto de activação de alojamento.

As seguintes sugestões são conhecidas e espera-se que os consultores de ponto de activação as reconheçam:

interactivo
Se este ponto de activação é uma sugestão "interactiva". I.e., consiste no resultado explícito de uma acção realizada pelo utilizador como, por exemplo, activar um assistente numa caixa de diálogo de assistente. Os valores aceitáveis são true e false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Um consultor de ponto de activação é um mecanismo de política que é consultado sempre que o sistema efectua uma acção à qual estão associadas actividades desactivadas. É da responsabilidade dos consultores perguntar se a acção deve ser continuada e, caso seja possível, quais são as actividades a activar.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Especifica uma associação entre um produto e um consultor. Estas associações determinam qual o consultor adequado para o produto actual (tal como está definido por org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Este elemento permite associar ícones a categorias. Estes ícones podem ser utilizados por componentes de interface do utilizador que pretendam visualizar categorias de alguma forma.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Este elemento permite associar ícones a actividades. Estes ícones podem ser utilizados por componentes de interface do utilizador que pretendam visualizar actividades de alguma forma.



De seguida é apresentado um exemplo de um ponto de activação não interactivo:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactivo"

value=

"false"

/>

</triggerPoint>

</extension>

De seguida é apresentado um exemplo de um consultor de ponto de activação associado a um produto específico:

  

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

De seguida é apresentado um exemplo de associação de imagens a actividades e categorias:

  

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

O valor do atributo class do identificador triggerPointAdvisor tem de ser o nome totalmente qualificado de uma classe que implemente org.eclipse.ui.activities.ITriggerPointAdvisor.

A implementação da área de trabalho (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) está disponível para que os clientes possam criar subclasses e reutilizá-la.