Podpora aktivity

org.eclipse.ui.activitySupport

3.1

Tento bod rozšíření se používá pro registraci různých rozšíření podpory týkajících se infrastruktury aktivit.

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

Určuje spouštěcí bod. Spouštěcí bod představuje identifikátor používaný generátorem aktivit k určení toho, zda má akce způsobovat zpřístupnění aktivit.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Pokyn představuje určitá data, která lze využít v rámci infrastruktury Eclipse ke stanovení chování podpory aktivity týkající se hostitelského spouštěcího bodu.

Následující pokyny jsou "dobře známé" a očekává se, že je poradci spouštěcích bodů rozpoznají:

interactive
Určuje, zda tento spouštěcí bod představuje "interaktivní" pokyn. Tj.: je explicitním výsledkem nějaké akce provedené uživatelem, např. aktivace průvodce v dialogovém okně Průvodce. Povolené hodnoty jsou true a false



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Poradce spouštěcího bodu představuje mechanizmus, na který se systém obrací pokaždé, když provádí akci, se kterou jsou přidruženy znepřístupněné aktivity. Úkolem poradce je odpovědět, zda by akce měla pokračovat, a pokud ano, jaké aktivity se mají povolit.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Určuje vazbu mezi produktem a poradcem. Tyto vazby určují, který poradce je pro aktuální produkt vhodný (jak je definováno pomocí org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Tento prvek umožňuje vytvářet vazby mezi ikonami a kategoriemi. Tyto ikony lze používat v rámci komponent uživatelského rozhraní, které si přejí kategorie nějak graficky znázornit.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Tento prvek umožňuje spojovat ikony s aktivitami. Tyto ikony lze používat v rámci komponent uživatelského rozhraní, které si přejí aktivity nějak graficky znázornit.



Následuje příklad neinteraktivního spouštěcího bodu:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Následuje příklad poradce spouštěcího bodu svázaného s konkrétním produktem:

  

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

Následuje příklad vytváření vazeb mezi obrázky a aktivitami nebo kategoriemi:

  

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

Hodnota atributu class značky triggerPointAdvisor musí představovat úplný kvalifikovaný název třídy implementující org.eclipse.ui.activities.ITriggerPointAdvisor.

Implementace modulu Workbench (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) je klientům k dispozici pro vytváření podtříd a opakované použití.