Muistilistaobjektin laajennus

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

Tätä laajennuspistettä voi käyttää, kun muistilistaan vaiheeseen halutaan lisätä uusi painike. Uusi määrite voidaan lisätä muistilistan sisältötiedoston item-tunnisteeseen. Kun muistilistakehys lukee kyseisen määritteen arvon, se tarkistaa, onko tähän laajennuspisteeseen rekisteröity määritteen käsittelevä luokka. Muistilistan sisältötiedostossa olevaa määritteen nimeä verrataan kaikkiin rekisteröityjen cheatsheetItemExtension-laajennuspisteen toteutusten itemAttribute-määritteen arvoihin. Jos vastine löytyy, muistilistakehys lataa määritetyn objektimääritteen käsittelyluokan ja lähettää sille muistilistan sisältötiedostoon määritetyn määritteen käsittelykutsun. Muistilistakehys voi käyttää luokkaa myös sen jälkeen, kun luokka on jäsentänyt objektimääritteen arvon. Kun objekti hahmonnetaan muistilistanäkymään, tätä luokkaa pyydetään käsittelemään osien lisäys yhdistelmään. Tähän yhdistelmään lisätyt objektit näkyvät muistilistavaiheessa (nykyisessä versiossa ohjekuvakkeen vieressä). Se näytetään vain määritteen sisältäneen item-tunnisteen (muistilistan sisältötiedostossa) määrittämässä vaiheessa. Tätä laajennuspistettä suositellaan käytettäväksi pienen (16 x 16) valintaikkunan avaamispainikkeen lisäämiseen.

<!ELEMENT extension (itemExtension)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT itemExtension EMPTY>

<!ATTLIST itemExtension

itemAttribute CDATA #REQUIRED

class         CDATA #REQUIRED>

Tämän objektilaajennuksen avulla voidaan lisätä elementtejä muistilistan vaiheisiin. Tätä laajennuspistettä voi käyttää kuvakkeiden ja painikkeiden lisäämiseen muistilistan vaiheisiin (tässä versiossa lisätyt objektit näkyvät ohjekuvakkeen vieressä). Käytettävät määritteet ovat muistilistan item-tunnisteeseen lisättävän määritteen nimi ja luokka, joka käsittelee muistilistan sisältötiedoston määritearvon jäsennyksen, kun muistilista ladataan. Määritteen arvon on oltava merkkijono. Määritetyllä luokalla on oltava aliluokka org.eclipse.ui.cheatsheets.AbstractItemExtensionElement. Kun muistilistan sisältötiedosto on jäsennetty ja ladattu, muistilistan vaiheeseen lisätään määritetyt kuvat tai painikkeet (tässä versiossa ne lisätään ohjepainikkeen viereen) kutsumalla laajennuspisteessä määritettyä luokkaa uudelleen.



Seuraavassa on tämän laajennuspisteen toteutusesimerkki:

<extension point=

"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"

>

<itemExtension itemAttribute=

"xyzButton"

class=

"com.example.HandleParsingAndAddButton"

>

</itemExtension>

</extension>

Tämän laajennuksen item-määrite on seuraava:

<item title=

"XYZ-nimi"

xyzButton=

"/icon/button.gif"

/>

Huomaa, että item-tunnisteen määritteen arvo voi olla mikä tahansa. Tämä johtuu siitä, että kyseisen määritteen jäsentävä luokka on HandleParsingAndAddButton, joka tässä esimerkissä jäsentää määritteeksi merkkijonon /icon/button.gif. Myöhemmin näiden tietojen perusteella ladataan gif-tiedosto, jota käytetään uuden painikkeen kuvakkeena.

API-tiedot ovat org.eclipse.ui.cheatsheets.AbstractItemExtensionElement-elementin Javadoc-ohjeissa.

Tässä versiossa ei ole toimitettua toteutusta.