Atividades

org.eclipse.ui.activities

3.0

O ponto de extensão org.eclipse.ui.activities é utilizado para declarar as atividades e os elementos associados. As atividades são utilizadas pela plataforma para filtrar determinadas contribuições de plug-in da visualização dos usuários até o momento em que eles expressem interesse. Isso permitirá que o Eclipse cresça dinamicamente com base no padrão de uso de um usuário.

<!ELEMENT extension (activity , activityRequirementBinding , activityPatternBinding , category , categoryActivityBinding , defaultEnablement)*>

<!ATTLIST extension

id    CDATA #IMPLIED

name  CDATA #IMPLIED

point CDATA #REQUIRED>


<!ELEMENT activity EMPTY>

<!ATTLIST activity

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Este elemento é utilizado para definir as atividades. Se houver mais de um desses elementos com o mesmo atributo id, apenas o último elemento declarado (na ordem de leitura do registro) será considerado válido.



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Esse elemento permite que alguém vincule atividades a atividades. O relacionamento ocorre de forma que se o activityId for ativado, o requiredActivityId também será ativado.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Esse elemento permite vincular atividades a padrões.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Esse elemento é utilizado para definir as categorias. Se houver mais de um desses elementos com o mesmo atributo id, apenas o último elemento declarado (na ordem de leitura do registro) será considerado válido.



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Esse elemento permite vincular categorias a atividades.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Esse elemento permite especificar que uma determinada atividade deva ser ativada por padrão.



A seguir está um exemplo de várias definições de atividade e de categoria bem como das ligações associadas.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"Filters contributions from com.xyz"

name=

"My Activity"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"Filters other contributions from com.xyz"

name=

"My Other Activity"

/>

<!-- other activity requires activity -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"com.xyz Activities"

name=

"My Category"

/>

<!-- put the activity in the category -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- bind all contributions from plugin com.xyz -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- bind my.contribution from plugin com.xyz.other -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

"com\.xyz\.other/my.contribution"

/>

<!-- our activity should be enabled by default -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

Não existe atualmente API pública para declarar as atividades ou os elementos associados além desse ponto de extensão. O estado de atividades no workbench pode ser acessado por meio de org.eclipse.ui.IWorkbench.getActivitySupport(). A partir daqui você pode consultar e atualizar o conjunto de atividades atualmente ativadas.

Não há "atividades padrão" fornecidas pelo workbench. As atividades foram projetadas para serem definidas no nível de produto, como o Eclipse SDK, para se integrarem bem a todos os componentes (conhecidos) que o produto contém.