Tevékenységtámogatás

org.eclipse.ui.activitySupport

3.1

Ez a kiterjesztési pont a tevékenységek infrastruktúrájával kapcsolatos különféle támogató kiterjesztések bejegyzésére használható.

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

Egy aktiválási pontot határoz meg. Az aktiválási pont egy azonosító, amelyet a tevékenység alrendszer használ annak meghatározására, hogy egy műveletnek a tevékenységek felkészítését kell-e eredményeznie, vagy sem.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Egy tipp adatokat ábrázol, amelyeket az Eclipse infrastruktúra használhat a kiszolgáló aktiválási ponttal kapcsolatos tevékenységtámogatás viselkedésének meghatározásához.

Az alábbi tippek "közismertek" és elvárható, hogy az aktiválási pontok tanácsadói ismerjék őket:

interactive
Ezen aktiválási pont tippje interaktív módon kerül-e megjelenítésre. Azaz ez egyértelmű eredménye a felhasználó által elvállalt olyan műveletnek, mint egy varázsló aktiválása a varázsló párbeszédablakban. Az elfogadott értékek a true és a false.



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Az aktiválási pont tanácsadója egy házirend-mechanizmus, amely minden olyan esetben felhasználásra kerül, amikor a rendszer elvállal egy műveletet, amely tiltott tevékenységekkel rendelkezik. A tanácsadó felelőssége annak megválaszolása, hogy egy műveletet folytatni kell-e és, ha igen, akkor milyen tevékenységeket kell engedélyezni.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Egy termék és tanácsadó közötti összekapcsolást ad meg. Ezek az összekapcsolások határozzák meg, hogy melyik tanácsadó megfelelő az aktuális termékhez (az org.eclipse.core.runtime.Platform.getProduct() által meghatározott módon).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Ez az elem ikonok kategóriákhoz kötését teszi lehetővé. Ezen ikonokat azon felhasználói felületek komponensei használhatják, amelyek valamilyen módon meg szeretnék jeleníteni a kategóriákat.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Ez az elem ikonok tevékenységekhez kötését teszi lehetővé. Ezen ikonokat azon felhasználói felületek komponensei használhatják, amelyek valamilyen módon meg szeretnék jeleníteni a tevékenységeket.



Az alábbiakban egy beavatkozást nem igénylő aktiválási pontra látható példa:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Alább egy példa látható egy adott termékhez kötött aktiválási pont tanácsadójára:

  

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

Alább egy példa látható a képek tevékenységekhez és kategóriákhoz kötésére:

  

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

A triggerPointAdvisor jelölő class attribútumának értéke az org.eclipse.ui.activities.ITriggerPointAdvisor felületet megvalósító osztály teljes képzésű neve kell, hogy legyen.

A munkaterület-megvalósítás (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) elérhető az ügyfelek számára a továbbszármaztatáshoz és újrafelhasználáshoz.