Markering - hjælp
Id:
org.eclipse.ui.ide.markerHelp
Siden:
3.0 (oprindeligt tilføjet i release 2.0 som org.eclipse.ui.markerHelp)
Beskrivelse:
Dette udvidelsespunkt bruges til at knytte en hjælpekontekst-id til en bestemt "type" markering (en markering af en bestemt type eller med bestemte attributværdier).
Konfigurationskode:
<!ELEMENT extension (markerHelp*)>
<!ATTLIST-udvidelse
point CDATA #REQUIRED
id CDATA #IMPLIED
navn CDATA #IMPLIED>
- point - en fuldstændig id for måludvidelsespunktet.
- id - en valgfri id for udvidelsesforekomsten.
- name - et valgfrit navn på udvidelsesforekomsten.
<!ELEMENT markerHelp (attribute*)>
<!ATTLIST markerHelp
markerType CDATA #IMPLIED
helpContextId CDATA #REQUIRED>
- markerType - den entydige markeringstype, som hjælpekonteksten gælder for.
- helpContextId - den entydige id for hjælpekonteksten.
<!ELEMENT attribute EMPTY>
<!ATTLIST attribute
navn CDATA #REQUIRED
value CDATA #REQUIRED>
- name - navnet på den attribut, hvis værdi angives.
- value - den angivne værdi af attributten.
Eksempler:
Her er et eksempel på en udvidelse til markeringshjælp (bemærk underelementet og den måde attributterne bruges på):
<udvidelsespunkt=
"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>
I eksemplet ovenfor knyttes en hjælpekontekst-id til markeringer af typen org.eclipse.ui.examples.readmetool.readmemarker, hvis org.eclipse.ui.examples.readmetool.id-attribut har værdien 1234.
API-oplysninger:
Det er op til udvikleren at sikre, at der kun leveres én hjælpekontekst-id for en bestemt markering. Hvis der leveres to eller flere kontekst-id'er for en bestemt type markering, definerer arbejdsbænken ikke, hvilken der returneres.
Men arbejdsbænken definerer ikke, at den "mest specifikke" kontekst-id altid returneres for en bestemt markering. Det vil sige, at der returneres en kontekst-id, som er knyttet til tre tilsvarende attributværdier, inden der returneres en kontekst-id, som kun er knyttet til to.
Copyright (c) 2002, 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which accompanies
this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html