Activités

org.eclipse.ui.activities

3.0

Le point d'extension org.eclipse.ui.activities sert à déclarer des activités et des éléments associés. Les activités sont employées par la plateforme pour filtrer certaines contributions de plug-ins à partir de la vue des utilisateurs tant que ceux-ci n'en ont pas besoin. Eclipse peut ainsi grossir de façon dynamique en fonction du modèle d'usage d'un utilisateur.

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

Cet élément est employé pour définir des activités. Si plusieurs de ces éléments possèdent le même attribut id, seul le dernier élément déclaré (dans l'ordre de lecture du registre) est considéré valide.



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Cet élément permet de lier des activités entre elles. La relation est telle que si activityId est activé, requiredActivityId l'est aussi.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Cet élément permet de relier des activités à des modèles.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name         CDATA #REQUIRED>

Cet élément est employé pour définir des catégories. Si plusieurs de ces éléments possèdent le même attribut id, seul le dernier élément déclaré (dans l'ordre de lecture du registre) est considéré valide.



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Cet élément permet de relier des catégories à des activités.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Cet élément permet d'indiquer qu'une activité donnée doit être activée par défaut.



L'exemple ci-dessous illustre plusieurs définitions d'activités et de catégories, ainsi que les liaisons associées.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"Filtre des contributions depuis com.xyz"

name=

"Mon activité"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"Filtre d'autres contributions depuis com.xyz"

name=

"Mon autre activité"

/>

<!-- autre activité requiert activité -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"Activités com.xyz"

name=

"Ma catégorie"

/>

<!-- mettre l'activité dans la catégorie -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- lier toutes les contributions depuis le plug-in com.xyz -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- lier my.contribution depuis le plug-in com.xyz.other -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

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

/>

<!-- notre activité doit être activée par défaut -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

Il n'existe actuellement aucune API publique pour déclarer des activités ou des éléments associés autres que ce point d'extension. L'état des activités dans le plan de travail est accessible via org.eclipse.ui.IWorkbench.getActivitySupport(). Vous pouvez y interroger et y mettre à jour l'ensemble d'activités actuellement activées.

Le plan de travail ne fournit aucune activité par défaut. Les activités doivent être définies au niveau du produit, tel qu'Eclipse SDK, afin d'intégrer tous les composants (connus) que le produit contient.