Průvodci obsahem modulu plug-in
Identifikátor:
org.eclipse.pde.ui.pluginContent
Popis:
Tento bod rozšíření poskytuje přispívající průvodce, kteří vytváří další obsah projektů modulů plug-in prostředí PDE. Po vytvoření souboru typu manifest modulu plug-in a klíčových souborů je možné tyto průvodce použít pro přidání dalších souborů a rozšíření do počáteční struktury. Typická implementace tohoto průvodce by přidala obsah založený na šabloně s parametry, která je přizpůsobena na základě uživatelských voleb v průvodci.
Cílem je dosáhnout modulu plug-in, který po vytvoření bude provádět užitečné akce (například přidá pohled, editor atd.).
Konfigurační markup:
<!ELEMENT extension (wizard*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
- point - Úplný identifikátor cílového bodu rozšíření.
- ID - Nepovinný identifikátor instance rozšíření.
- name - Nepovinný název instance rozšíření.
<!ELEMENT wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
category CDATA #IMPLIED
ui-content (true | false) "true"
java (true | false) "true"
rcp (true | false) "false"
pureOSGi (true | false) "false"
requiresActivator (true | false) "false"
>
- ID - Jedinečný název, který bude použit k identifikaci tohoto průvodce.
- name - Přeložitelný název, který bude použit ve znázornění uživatelského rozhraní tohoto průvodce.
- icon - Relativní cesta ikony, která bude použita k vizuálnímu znázornění průvodce.
- class - Úplný název třídy, která implementuje rozhraní org.eclipse.pde.ui.IPluginContentWizard.
- category - Nepovinný příznak, který může být použit pro přidružení průvodců obsahem k různým cílovým projektům.
- ui-content - Příznak, který označuje, zda bude průvodce přidávat kód pomocí obsahu uživatelského rozhraní. Tento příznak ovlivňuje, která třída modulu plug-in bude vybrána (moduly plug-in uživatelského rozhraní rozšiřují třídu
AbstractUIPlugin, zatímco jiné moduly plug-in rozšiřují základní třídu Plugin). Vzhledem k tomu, že mnoho příspěvků do platformy Eclipse zahrnuje obsah uživatelského rozhraní, je ve výchozím nastavení tento atribut nastaven na hodnotu true.
- java - Příznak, který označuje, že průvodce bude přidávat obsah v jazyce Java. Vzhledem k tomu, že většina modulů plug-in platformy Eclipse obsahuje kód Java, je ve výchozím nastavení tento atribut nastaven na hodnotu
true. Nastavte hodnotu false, jestliže modul plug-in neobsahuje kód Java (například pouze soubory dokumentace).
- rcp - Od verze 3.1. Logický příznak indikující, zda průvodce poskytuje samostatnou plně funkční aplikaci rozšířeného klienta. Je-li nastaveno na
true, průvodce se objeví v průvodci Nový projekt modulu plug-in pouze tehdy, když uživatel vybere volbu Aplikace rozšířeného klienta.
- pureOSGi - Od verze 3.2. Logický příznak indikující, zda průvodce poskytuje jasný balík OSGi. Pokud je nastaven na
true, objeví se průvodce v průvodci nového projektu modulu plug-in pouze tehdy, když uživatel vybere možnost vytvořit jasný balík OSGi.
- requiresActivator - Od verze 3.2. Logický příznak indikující, zda průvodce poskytuje třídu aktivátoru. Pokud je nastaven na
true, objeví se průvodce v průvodci nového projektu modulu plug-in pouze tehdy, když uživatel vybere možnost vytvořit aktivátor pro kontrolu životního cyklu modulu plug-in.
<!ELEMENT description (#PCDATA)>
Krátký popis tohoto průvodce.
Příklady:
Následuje příklad bodu rozšíření:
<extension point="org.eclipse.pde.ui.pluginContent">
<wizard
name="Example Plug-in Content Generator"
icon="icons/content_wizard.gif"
class="com.example.xyz.ContentGeneratorWizard"
id="com.example.xyz.ExampleContentGenerator">
<description>
Přidá pohled a stránku předvoleb.
</description>
</wizard>
</extension>
Informace rozhraní API:
Průvodci, kteří se připojují k tomuto bodu rozšíření, musí implementovat rozhraní org.eclipse.pde.ui.IPluginContentWizard a měly by rozšiřovat rozhraní org.eclipse.jface.wizard.Wizard.
Dodaná implementace:
Prostředí PDE poskytuje rozhraní API pro vkládání průvodců obsahem založených na upravitelných šablonách. Některé konkrétní průvodce založené na těchto šablonách přidává samotné uživatelské rozhraní prostředí PDE.
Copyright (c) 2004 IBM Corporation a další.
Všechna práva vyhrazena. Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html