Nápověda pro značkovač

org.eclipse.ui.ide.markerHelp

3.0 (původně přidána ve verzi 2.0 jako org.eclipse.ui.markerHelp)

Tento bod rozšíření se používá k asociaci ID kontextu nápovědy se specifickým "druhem" značkovače (značkovač určitého typu nebo s určitými hodnotami atributu).

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


Následuje příklad rozšíření nápovědy značkovače (všimněte si dílčího prvku a způsobu použití atributů):

 

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

Ve výše uvedeném příkladu je ID kontextu nápovědy asociováno se značkovači typu org.eclipse.ui.examples.readmetool.readmemarker, jejichž atribut org.eclipse.ui.examples.readmetool.id má hodnotu 1234.

Je na vývojáři, aby zajistil, že pro daný značkovač je dodáno pouze jedno ID kontextu nápovědy. Pokud jsou pro daný druh značkovače dodány dvě nebo více ID kontextu nápovědy, pracovní plocha nedefinuje, které bude vráceno. Nicméně pracovní plocha definuje, že bude vždy vráceno pro daný značkovač "nejspecifičtější" ID kontextu. Takže ID kontextu asociované se třemi souhlasícími hodnotami atributu bude vráceno před ID kontextu asociovaným pouze se dvěma.