Справка по маркеру

org.eclipse.ui.ide.markerHelp

3.0 (первоначально включено в выпуск 2.0 как org.eclipse.ui.markerHelp)

Эта точка расширения служит для связывания идентификатора контекста справки с маркером особого "вида" (маркер определенного типа или маркер с определенными значениями атрибутов).

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


Пример расширения справки по маркеру (обратите внимание, что используется подэлемент и атрибут пути):

 

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

В этом примере идентификатор контекста справки связывается с маркерами типа org.eclipse.ui.examples.readmetool.readmemarker, значение атрибута org.eclipse.ui.examples.readmetool.id которых равно 1234.

Разработчик должен обеспечить соответствие заданному маркеру только одного идентификатора контекста справки. Если заданному виду маркера соответствуют два или более идентификатора контекста, то рабочая среда не задает, какой из них будет возвращен. Однако рабочая среда обеспечивает, что для заданного типа маркера всегда будет возвращаться "наиболее точный" идентификатор контекста справки. Это означает, что будет возвращен идентификатор контекста, связанный с тремя значениями атрибута, а не связанный только с двумя.