Merkinnän ohje
Tunnus:
org.eclipse.ui.ide.markerHelp
Alkaen versiosta:
3.0 (lisättiin alun perin versioon 2.0 tunnisteella org.eclipse.ui.markerHelp)
Kuvaus:
Tämän laajennuspisteen avulla tietyn lajin merkintöihin voidaan yhdistää ohjetunnus (yhdistämisen voi tehdä merkinnän lajin tai sen määritteiden arvojen perusteella).
Merkintärakenne:
<!ELEMENT extension (markerHelp*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - kohdelaajennuspisteen tarkka tunnus.
- id - laajennuksen ilmentymän valinnainen tunnus.
- name - laajennuksen ilmentymän valinnainen nimi.
<!ELEMENT markerHelp (attribute*)>
<!ATTLIST markerHelp
markerType CDATA #IMPLIED
helpContextId CDATA #REQUIRED>
- markerType - sen merkinnän yksilöivä laji, jota ohje koskee.
- helpContextId - ohjeen yksilöllinen tunnus.
<!ELEMENT attribute EMPTY>
<!ATTLIST attribute
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - sen määritteen nimi, jonka arvo määritetään.
- value - määritteelle annettu arvo.
Esimerkkejä:
Seuraavassa on esimerkki merkinnän ohjelaajennuksesta (huomaa, miten alielementtiä ja määritteitä on käytetty):
<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>
Edellisessä esimerkissä ohje yhdistetään lajin org.eclipse.ui.examples.readmetool.readmemarker
merkintöihin, joiden org.eclipse.ui.examples.readmetool.id-määritteen arvo on 1234.
API-tiedot:
Sovelluskehittäjän on varmistettava, että kullekin merkinnälle on määritetty vain yksi ohje.
Jos merkinnälle on määritetty useampi kuin yksi ohje, palautettavaa ohjetta ei voi määrittää työympäristöön.
Työympäristö kuitenkin määrittää palautettavan ohjeen selvittämällä, mikä ohjeista vastaa kohdetta parhaiten.
Tällöin esimerkiksi ohje, jossa on kolme vastaavaa määritteen arvoa, palautetaan ennen ohjetta, jossa on vain kaksi vastaavaa määritteen arvoa.
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