Merkinnän ohje

org.eclipse.ui.ide.markerHelp

3.0 (lisättiin alun perin versioon 2.0 tunnisteella org.eclipse.ui.markerHelp)

Tämän laajennuspisteen avulla tietyn lajin merkintöihin voidaan yhdistää ohjetunnus (yhdistämisen voi tehdä merkinnän lajin tai sen määritteiden arvojen perusteella).

<!ELEMENT extension (markerHelp*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT markerHelp (attribute*)>

<!ATTLIST markerHelp

markerType    CDATA #IMPLIED

helpContextId CDATA #REQUIRED>


<!ELEMENT attribute EMPTY>

<!ATTLIST attribute

name  CDATA #REQUIRED

value CDATA #REQUIRED>


Seuraavassa on esimerkki merkinnän ohjelaajennuksesta (huomaa, miten alielementtiä ja määritteitä on käytetty):

 

<extension point=

"org.eclipse.ui.ide.markerHelp"

>

<markerHelp markerType=

"org.eclipse.ui.examples.readmetool.readmemarker"

helpContextId=

"org.eclipse.ui.examples.readmetool.marker_example1_context"

>

<attribute name=

"org.eclipse.ui.examples.readmetool.id"

value=

"1234"

/>

</markerHelp>

</extension>

Edellisessä esimerkissä ohje yhdistetään lajin org.eclipse.ui.examples.readmetool.readmemarker merkintöihin, joiden org.eclipse.ui.examples.readmetool.id-määritteen arvo on 1234.

Sovelluskehittäjän on varmistettava, että kullekin merkinnälle on määritetty vain yksi ohje. Jos merkinnälle on määritetty useampi kuin yksi ohje, palautettavaa ohjetta ei voi määrittää työympäristöön. Työympäristö kuitenkin määrittää palautettavan ohjeen selvittämällä, mikä ohjeista vastaa kohdetta parhaiten. Tällöin esimerkiksi ohje, jossa on kolme vastaavaa määritteen arvoa, palautetaan ennen ohjetta, jossa on vain kaksi vastaavaa määritteen arvoa.