Toimintotuki

org.eclipse.help.base.activitySupport

3.1

Tuotelisäosat määrittävät tämän laajennuspisteen avulla ohjejärjestelmän toimintatavan toimintoja käytettäessä. Tämän laajennuspisteen avulla voidaan määrittää seuraavat ominaisuudet:

Tämä laajennuspiste on kokeellinen, joten sitä tullaan todennäköisesti muuttamaan tulevissa versioissa toimintatuen kehittyessä.

<!ELEMENT extension (support+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT support (localScopeCheckbox , documentMessage , showAllMessage)>

<!ATTLIST support

productId CDATA #REQUIRED>


<!ELEMENT showAllMessage (#PCDATA)>

Tämä elementti sisältää tekstimuotoisen sanoman, joka näytetään valintaikkunassa, kun toimintojen suodatus poistetaan käytöstä. Tämän sanoman tulisi varoittaa käyttäjää siitä, että ilman suodatinta osa ohjeista saattaa viitata käyttöliittymän osiin, jotka eivät ole näkyvissä.



<!ELEMENT localScopeCheckbox (#PCDATA)>

Tämä elementti määrittää paikallisen haun oletusasetussivulla käytettävän valintaruudun nimiön. Kun tämä valintaruutu valitaan, haku palauttaa myös sellaiset hakuehtoja vastaavat ohjeet, jotka liittyvät käytöstä poistettuihin toimintoihin.



<!ELEMENT documentMessage EMPTY>

<!ATTLIST documentMessage

class    CDATA #IMPLIED

pluginId CDATA #REQUIRED>

Tämä elementti määrittää HTML-katkelman, joka lisätään käytöstä poistettuihin toimintoihin liittyvien ohjeiden alkuun. Tämän sanoman tarkoituksena on ilmoittaa käyttäjälle, että osa ohjeista saattaa viitata käyttöliittymän osiin, jotka eivät ole näkyvissä. Koska sanoman teksti on XML-tiedostossa, HTML-tunnisteissa on käytettävä XML-koodin mukaisia erikoismerkkien koodinvaihtomerkkejä.

Sanomassa voi olla hyperlinkki, jonka avulla käyttäjä voi siirtyä toimintojen muokkausohjelmaan ja muuttaa toiminnon tilaa. Tällöin elementtiin on lisättävä class-määrite.



Seuraavassa toimintotuen laajennuspisteen käyttöesimerkki:

 

<extension point=

"org.eclipse.help.base.activitySupport"

>

<support productId=

"com.example.xyzProduct"

>

<showAllMessage>

Tämä toiminto tuo näkyviin kaikki sisällysluettelon ohjeaiheet.

</showAllMessage>

<documentMessage class=

"com.example.xyz.OpenRolePreference"

>

Tämä ohje liittyy rooliin, joka on tällä hetkellä poistettu käytöstä. &lt;p&gt; Voit ottaa roolin käyttöön avaamalla &lt;a href="ACTIVITY_EDITOR"&gt;Roolit-oletusasetussivun.&lt;/a&gt;

</documentMessage>

</support>

</extension>

DocumentMessage-elementin class-määritteen arvon on toteuttava org.eclipse.help.ILiveHelpAction-liittymä.

Eclipse SDK sisältää oletustoimintotuen, jonka käytöstä poistettuihin toimintoihin liittyvien ohjeiden sanomissa oleva hyperlinkki avaa Toiminnot-oletusasetussivun. Jos korvaat tämän toimintotuen, varmista, että tekemäsi muutokset ja käyttämäsi termit ovat käyttöliittymän mukaiset.