Toimintotuki

org.eclipse.ui.activitySupport

3.1

Tämän laajennuspisteen avulla voidaan rekisteröidä erilaisia toimintorakenteen tukilaajennuksia.

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

Tämä elementti määrittää liipaisinpisteen. Liipaisinpiste on tunnus, jonka avulla toiminto-ohjelma määrittää, aiheuttaako jokin tietty toiminto muita toimintoja.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Hint-elementti sisältää vihjemäärityksen, jonka tietojen avulla Eclipse-rakenne voi selvittää, miten toimintotukea sovelletaan suhteessa liipaisinpisteeseen.

Seuraavat vihjemääritykset ovat yleisesti käytettyjä, joten liipaisinpisteen neuvontatoimintojen voi olettaa tunnistavan ne:

interactive
Liipaisinpisteen vuorovaikutteisuusmääritys. Vuorovaikutteinen toiminto on käyttäjän toiminnan (esimerkiksi ohjatun toiminnon aloitus valintaikkunasta) välitön seuraus. Kelvolliset arvot ovat true (tosi) ja false (epätosi).



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Liipaisinpisteen neuvontatoiminto on käytäntömekanismi, jota käytetään aina, kun järjestelmän toimeen liittyy käytöstä poistettuja toimintoja. Neuvontatoiminto määrittää, jatketaanko toimen toteutusta ja mitä toimintoja otetaan käyttöön.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Tämä elementti määrittää tuotteen ja neuvontatoiminnon välisen sidonnan. Nämä sidonnat määrittävät, mikä neuvontatoiminto vastaa käytettyä tuotetta (joka selvitetään org.eclipse.core.runtime.Platform.getProduct()-toiminnon avulla).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Tämän elementin avulla voidaan sitoa kuvakkeita luokkiin. Käyttöliittymän komponentit voivat käyttää näitä kuvakkeita luokkien visuaalisina tunnisteina.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Tämän elementin avulla voidaan sitoa kuvakkeita toimintoihin. Käyttöliittymän komponentit voivat käyttää näitä kuvakkeita toimintojen visuaalisina tunnisteina.



Seuraavassa on esimerkki liipaisinpisteestä, joka ei ole vuorovaikutteinen:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Seuraavassa on esimerkki liipaisinpisteen neuvontatoiminnon sitomisesta tuotteeseen:

  

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

Seuraavassa on esimerkki kuvien sitomisesta toimintoihin ja luokkiin:

  

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

TriggerPointAdvisor-tunnisteen class-määritteen arvon on oltava sen luokan tarkka nimi, joka toteuttaa org.eclipse.ui.activities.ITriggerPointAdvisor-liittymän.

Asiakkaat voivat käyttää työympäristön toteutusta (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) aliluokkana.