Suporte à Atividade

org.eclipse.ui.activitySupport

3.1

Esse ponto de extensão é utilizado para registrar várias extensões de suporte relativas à infra-estrutura de atividades.

<!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 acionador. Um ponto acionador é um identificador utilizado pelo mecanismo de atividade para determinar se uma ação deve provocar a ativação de atividades ou não.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Uma sugestão representa alguns dados que podem ser utilizados pela infra-estrutura do eclipse para determinar o comportamento do suporte à atividade relativo ao ponto acionador do hosting.

As sugestões a seguir são "bem conhecidas" e espera-se que os orientadores do ponto acionador as conheçam:

interactive
Se esse ponto acionador é sugestão em um modo "interativo". Isto é: é o resultado explícito de uma ação executada pelo usuário como ativar um assistente no diálogo do assistente. Os valores aceitáveis são true e false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Um orientador do ponto acionador é um mecanismo de política consultado sempre quando o sistema executa uma ação que desativa atividades associadas a ele. É de responsabilidade dos orientadores responder se uma ação deve prosseguir e, se ela puder, quais atividades ativar.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Especifica uma ligação entre um produto e um orientador. Essas ligações determinam qual orientador é apropriado para o produto atual (conforme definido pelo org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Esse elemento permite ligação de ícones a categorias. Esses ícones podem ser utilizados pelos componentes da interface com o usuário que desejam visualizar categorias de algum modo.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Esse elemento permite a ligação de ícones com atividades. Esses ícones podem ser utilizados pelos componentes da interface com o usuário que desejam visualizar atividades de algum modo.



A seguir, encontra-se um exemplo de um ponto acionador não-interativo:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

A seguir, encontra-se um exemplo de um orientador do ponto acionador ligado 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>

A seguir, encontra-se um exemplo de ligação de imagens a atividades 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 da tag triggerPointAdvisor deve ser o nome completo de uma classe que implementa o org.eclipse.ui.activities.ITriggerPointAdvisor.

A implementação do workbench (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) está disponível para clientes para subclassificação e reutilização.