Muistilistan sisältö

org.eclipse.ui.cheatsheets.cheatSheetContent

3.0

Tämän laajennuspisteen avulla voidaan rekisteröidä muistilistan sisältölisäyksiä. Muistilistat näkyvät Ohje-valikon vaihtoehtoina ja muistilistanäkymässä. Yleensä niitä käytetään käyttäjän apuna monimutkaisia tehtäviä edellyttävien toimien suorittamisessa.

Muistilistat on järjestetty luokkiin, jotka vastaavat yleensä tiettyjä ongelma-alueita. Esimerkiksi Java-lisäosa voi määrittää Java-luokan, joka soveltuu muistilistoille, jotka auttavat käyttäjää Java-työkalujen käytössä. Yhden lisäosan määrittämiin luokkiin voi viitata muissa lisäosissa käyttämällä cheatsheet-elementin luokkamääritettä (category). Muistilistat, joita ei ole luokiteltu tai joiden luokkapolut ovat virheelliset, sijoitetaan Muut-luokkaan.

Muistilistoissa voi olla description-alielementti, jonka runko-osa on muistilistaa kuvaava teksti.

<!ELEMENT extension (category | cheatsheet | taskEditor | taskExplorer)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT category EMPTY>

<!ATTLIST category

id             CDATA #REQUIRED

name           CDATA #REQUIRED

parentCategory CDATA #IMPLIED>

CheatsheetContent-laajennuspisteen category-elementin avulla voidaan luoda uusi luokka muistilistavalikkoon. Muistilistavalikko on työympäristön ohjevalikossa. Määritettyyn uuteen luokkaan voi liittää muistilistoja, jotka näkyvät kyseisessä luokassa muistilistojen valintaikkunassa.



<!ELEMENT cheatsheet (description?)>

<!ATTLIST cheatsheet

id          CDATA #REQUIRED

name        CDATA #REQUIRED

category    CDATA #IMPLIED

contentFile CDATA #IMPLIED

listener    CDATA #IMPLIED

composite   (true | false) "false">

Cheatsheet-elementti lisätään cheatsheetContent-laajennuspisteeseen haluttaessa lisätä työympäristöön muistilista. Cheatsheet-elementin pakolliset osat ovat tunnus, valintatilanteissa näytettävä käännettävä nimi, muistilistan kohdeluokan luokkatunnus ja sisältötiedosto. Muistilistan sisältötiedosto on XML-tiedosto, johon on määritetty muistilistan vaiheet ja toiminnot.



<!ELEMENT description (#PCDATA)>

Tähän elementtiin voidaan määrittää muistilistan lyhyt kuvaus.



<!ELEMENT taskEditor EMPTY>

<!ATTLIST taskEditor

id    CDATA #REQUIRED

class CDATA #REQUIRED

icon  CDATA #REQUIRED>

Tämä laajennuspiste on ehdollinen ja perustuu ehdolliseen sovellusohjelmaliittymäluokkaan TaskEditor. TaskEditor-laajennuspisteen avulla voit käyttää koostemuistilistan muokkausruudussa mukautettua käyttöliittymää. Jokainen koostemuistilistan tehtävä, joka vastaa tämän laajennuksen tunnusta, käyttää tässä laajennuspisteessä määritettyä luokkaa muokkausalueen luomiseen.



<!ELEMENT taskExplorer EMPTY>

<!ATTLIST taskExplorer

id    CDATA #REQUIRED

class CDATA #IMPLIED

icon  CDATA #IMPLIED

name  CDATA #REQUIRED>

Tämä laajennuspiste on ehdollinen ja perustuu ehdolliseen sovellusohjelmaliittymäluokkaan TaskExplorer. Laajennuspisteen avulla voit lisätä tehtävien selausnäkymän, jota käytetään koostemuistilistan avauksessa.



Seuraavassa on cheatSheetContent-laajennuspisteen käyttöesimerkki:

<extension point=

"org.eclipse.ui.cheatsheets.cheatSheetContent"

>

<category name=

"Esimerkkiluokka"

id=

"com.example.category"

>

</category>

<cheatsheet name=

"Mallimuistilista"

category=

"com.example.category"

id=

"com.example.cheatSheet"

contentFile=

"ExampleCheatSheet.xml"

>

<kuvaus>

Tämä on muistilistan kuvausteksti.

</description>

</cheatsheet>

</extension>

Lisätietoja on API-paketin org.eclipse.ui.intro.cheatsheets määrityksessä.

Ympäristössä ei ole sisäisiä muistilistoja.