Aktivitätsunterstützung

org.eclipse.ui.activitySupport

3.1

An diesem Erweiterungspunkt können verschiedene Unterstützungserweiterungen in Bezug auf die Aktivitätsinfrastruktur registriert werden.

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

Gibt einen Auslöserpunkt an. Ein Auslöserpunkt ist eine ID, die durch die Aktivitätssteuerkomponente verwendet wird, um festzulegen, ob eine Aktion die Aktivierung von Aktivitäten veranlassen soll oder nicht.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Ein Hinweis stellt Daten dar, die durch die Eclipse-Infrastrukture verwendet werden können, um das Verhalten der Aktivitätsunterstützung in Bezug auf den aufnehmenden Auslöserpunkt festzulegen.

Die folgenden Hinweise sind "gut bekannt", und es wird erwartet, dass Auslöserpunkt-Advisorfunktionen sie bestätigen:

interactive
Ob dieser Auslöserpunkt ein Hinweis auf eine "interaktive" Weise ist. Das heißt, es ist das explizite Ergebnis einer durch den Benutzer ausgeführten Aktion, z.B. die Aktivierung eines Assistenten im Assistentendialog. Akzeptierte Werte sind true und false.



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Eine Auslöserpunkt-Advisor-Funktion ist ein Richtlinienmechanismus, der konsultiert wird, wenn das System eine Aktion durchführt, die damit verbundene Aktivitäten deaktiviert hat. Es liegt in der Verantwortung der Advisor-Funktion zu antworten, ob eine Aktion fortgeführt werden soll und, wenn dies so ist, welche Aktivitäten zu aktivieren sind.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Legt eine Verbindung zwischen einem Produkt und einer Advisor-Funktion fest. Diese Verbindung bestimmt, welche Advisor-Funktion für das aktuelle Produkt geeignet ist (so wie durch org.eclipse.core.runtime.Platform.getProduct()) definiert.



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Dieses Element ermöglicht die Verbindung zwischen Symbolen und Kategorien. Diese Symbole können durch Komponenten der Benutzerschnittstelle verwendet werden, die Kategorien auf irgendeine Weise darstellen möchten.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Mit diesem Element können Symbole mit Aktivitäten verbunden werden. Diese Symbole können durch Komponenten der Benutzerschnittstelle verwendet werden, die Aktivitäten auf irgendeine Weise darstellen möchten.



Beispiel eines nicht-interaktiven Auslöserpunkts:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Beispiel einer Auslöserpunkt-Advisorfunktion, verbunden mit einem bestimmten Produkt:

  

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

Beispiel für eine Verbindung zwischen Images und Aktivitäten und Kategorien:

  

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

Der Wert des Attributs class des Tags 'triggerPointAdvisor' muss der vollständig qualifizierte Name einer Klasse sein, die org.eclipse.ui.activities.ITriggerPointAdvisor implementiert.

Die Workbench-Implementierung org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) steht Clients für Unterklassen udn Wiederverwendung zur Verfügung.