Jelző súgó

org.eclipse.ui.ide.markerHelp

3.0 (eredetileg az 2.0 kiadásba került be, mint org.eclipse.ui.markerHelp)

Ez a kiterjesztési pont szolgál egy súgókörnyezet-azonosító egy bizonyos "fajtájú" (egy adott típusú, vagy bizonyos attribútumértékekkel rendelkező) jelzőhöz rendelésére.

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


Az alábbiakban bemutatunk egy példát egy jelzősúgó kiterjesztésre (figyelje meg a részelem és az attribútumok használatának módját):

 

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

A fenti példában a súgókörnyezet-azonosító azon org.eclipse.ui.examples.readmetool.readmemarker típusú jelzőkhöz van társítva, amelyek org.eclipse.ui.examples.readmetool.id attribútumának értéke 1234.

A fejlesztő dolga, hogy biztosítsa, hogy csak egyetlen súgókörnyezet-azonosító legyen megadva egy adott jelzőhöz. Ha két vagy több súgókörnyezet-azonosító van megadva egy adott fajtájú jelzőhöz, akkor a munkaterület nem határozza meg, hogy melyik kerül visszaadásra. A munkaterület azonban meghatározza, hogy a "legspecifikusabb" környezetazonosító mindig visszaadásra kerül egy adott jelzőhöz. Vagyis ha van olyan környezetazonosító, amelynek három attribútumértéke egyezik, akkor ez kerül visszaadásra egy olyan előtt, amelynek csak kettő.