Pomoc do znacznika
Identyfikator:
org.eclipse.ui.ide.markerHelp
Dostępne od wersji:
3.0 (pierwotnie dodany w wersji 2.0 pod nazwą org.eclipse.ui.markerHelp)
Opis:
Ten punkt rozszerzenia
umożliwia powiązanie identyfikatora kontekstu pomocy z określonym rodzajem
znacznika (znacznikiem pewnego typu lub o określonych wartościach atrybutów).
Znaczniki konfiguracji:
<!ELEMENT extension (markerHelp*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA
#IMPLIED
name CDATA #IMPLIED>
- point - pełny identyfikator docelowego punktu rozszerzenia.
- id - opcjonalny identyfikator instancji rozszerzenia.
- name - opcjonalna nazwa instancji rozszerzenia.
<!ELEMENT markerHelp (attribute*)>
<!ATTLIST markerHelp
markerType CDATA #IMPLIED
helpContextId CDATA #REQUIRED>
- markerType - unikalny typ znacznika, którego dotyczy ten kontekst pomocy.
- helpContextId - unikalny identyfikator kontekstu pomocy.
<!ELEMENT attribute EMPTY>
<!ATTLIST attribute
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - nazwa atrybutu, którego wartość jest określana.
- value - określona wartość atrybutu.
Przykłady:
Poniżej przedstawiono
przykład rozszerzenia pomocy znacznika (warto zwrócić uwagę na podelement i sposób użycia atrybutów):
<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>
W powyższym przykładzie identyfikator kontekstu pomocy jest powiązany ze
znacznikami typu org.eclipse.ui.examples.readmetool.readmemarker, których
atrybut org.eclipse.ui.examples.readmetool.id ma wartość 1234.
Informacje o interfejsie API:
Programista powinien zadbać o to, aby dla danego znacznika był podany tylko
jeden identyfikator kontekstu pomocy. Jeśli dla danego rodzaju znacznika
zostaną podane dwa lub więcej identyfikatorów kontekstu pomocy, środowisko
robocze nie określa, który z nich będzie zwracany. Środowisko robocze
określa jednak, że dla danego znacznika zawsze zwracany będzie najbardziej
charakterystyczny identyfikator kontekstu. Oznacza to, że identyfikator kontekstu
powiązany z trzema pasującymi wartościami atrybutów zostanie zwrócony przed
identyfikatorem kontekstu powiązanym tylko z dwoma wartościami.
Copyright (c) 2002, 2004 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach
licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i
dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.