Ohjesisällön tuottaja
Tunnus:
org.eclipse.help.contentProducer
Käytettävissä versiosta:
3.0
Kuvaus:
Tämän laajennuspisteen avulla voidaan lisätä dynaamista, käytön aikana luotua ohjesisältöä. Sisällöntuottajat on rekisteröity lisäosittain, ja ne toimivat vain lisäosan vaikutusalueella. Jos haluat käyttää sisällöntuottajaa uudelleen toisessa lisäosassa, käytä binding
-elementtiä. Tämä estää lisäosia kaappaamasta kaikkien lisäosien sisällöntuotantoa. Sitoutumalla sisällöntuottajaan lisäosa antaa sille luvan hallita sisällöntuotantoa kaikissa myöntävän lisäosan asiakirjoissa.
Merkintärakenne:
<!ELEMENT extension (contentProducer | binding)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT contentProducer (producer)>
<!ATTLIST contentProducer
producer CDATA #IMPLIED>
- producer - ohjesisällön tuottajan toteutusluokka. Tämän luokan on toteutettava org.eclipse.help.IHelpContentProducer-liittymä. Tämä elementti ei ole pakollinen; sen sijasta voi käyttää sisäkkäistä producer-elementtiä.
<!ELEMENT producer (parameter*)>
<!ATTLIST producer
class CDATA #REQUIRED>
- class - ohjesisällön tuottajan toteutusluokka. Tämän luokan on toteutettava org.eclipse.help.IHelpContentProducer-liittymä.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - toteutusluokalle välitettävän parametrin nimi.
- value - toteutusluokalle välitettävän parametrin arvo.
<!ELEMENT binding EMPTY>
<!ATTLIST binding
producerId CDATA #REQUIRED>
- producerId - toisaalla contentProducer-elementin avulla määritetyn sisällöntuottajan yksilöllinen tunnus. Sidonnan avulla lisäosa voi käyttää uudelleen sisällöntuottajaa, joka on rekisteröity toiseen lisäosaan. Näin sen ei tarvitse määrittää omaansa.
Esimerkkejä:
Seuraavassa on esimerkki sisällöntuotannon laajennuspisteen käytöstä:
<extension point=
"org.eclipse.help.contentProducer"
id=
"org.eclipse.myPlugin.myDynamicHelpProducer"
name=
"Oma dynaaminen ohjesisältö"
>
<contentProducer producer=
"org.eclipse.myPlugin.myPackage.Myproducer"
/>
</extension>
API-tiedot:
Toimitetun sisällön tuottajaluokan on toteutettava org.eclipse.help.IHelpContentProducer-liittymä.
Tuottaja vastaa dynaamisten ohjeresurssien sisällön tuottamisesta lisäosasta. Ohjejärjestelmä kutsuu sisällön tuottajan metodia aina, kun lisäosasta haetaan jokin ohjeresurssi.
Toimitettu toteutus:
ei ole. Jos ohjelisäosaan ei ole määritetty ohjesisällön tuottajaa tai sen tulosten kutsumääritystä, ohjejärjestelmä etsii muokkaamattoman asiakirjan doc.zip-tiedostosta ja tiedostojärjestelmästä (lisäosan asennushakemistosta) ja näyttää sen sisällön.
Copyright (c) 2000, 2006 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