Attività

org.eclipse.ui.activities

3.0

Il punto di estensione org.eclipse.ui.activities viene utilizzato per dichiarare attività ed elementi associati. Le attività vengono utilizzate dalla piattaforma per filtrare determinati contributi del plugin dalle viste degli utenti quando gli utenti esprimono interesse per tali contributi. Ciò consente a Eclipse di crescere in modo dinamico in base al modello di utilizzo di un utente.

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

Questo elemento è utilizzato per definire le attività. Se esistono più elementi di questo tipo con lo stesso attributo id, viene considerato valido solo l'ultimo elemento dichiarato (in ordine di lettura del registro).



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Questo elemento consente di collegare le attività ad altre attività. La relazione è tale che se activityId è abilitato, è abilitato anche requiredActivityId.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Questo elemento consente di collegare le attività ai modelli.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name         CDATA #REQUIRED>

Questo elemento è utilizzato per definire le categorie. Se esistono più elementi di questo tipo con lo stesso attributo id, viene considerato valido solo l'ultimo elemento dichiarato (in ordine di lettura del registro).



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Questo elemento consente di collegare le categorie alle attività.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Questo elemento consente di specificare che una determinata attività deve essere abilitata per impostazione predefinita.



Di seguito è riportato un esempio di definizione di attività e categoria oltre ai binding associati.

 

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

Non è attualmente presente un'API pubblica per la dichiarazione delle attività o elementi associati diversa da questo punto di estensione. Lo stato delle attività nel workbench è accessibile mediante org.eclipse.ui.IWorkbench.getActivitySupport(). Da qui è possibile effettuare query e aggiornare l'insieme di attività attualmente abilitate.

Non esiste alcuna "attività predefinita" fornita dal workbench. Le attività sono definite a livello del prodotto, ad esempio Eclipse SDK, in modo da integrare tutti i componenti contenuti nel prodotto.