Průvodci vytvářením rozšíření
Identifikátor:
org.eclipse.pde.ui.newExtension
Popis:
Tento bod rozšíření by měl být použit pro přidání průvodců, kteří budou sloužit k vytvoření a úpravě nových rozšíření v editoru manifestu modulu plug-in prostředí PDE. Průvodci mohou současně vytvářet více rozšíření, ale i kód, který je potřebný k implementaci těchto rozšíření. Jestliže je přidaný průvodce vytvořen specificky pro konkrétní bod rozšíření, je doporučeno také registrovat odpovídajícího průvodce editorem. Tento průvodce bude použit k úpravě bodu rozšíření v editoru manifestu poté, co je vytvořen v souboru manifestu.
Konfigurační markup:
<!ELEMENT extension (wizard | category | editorWizard)*>
<!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 #IMPLIED
availableAsShortcut (true | false)
category CDATA #IMPLIED
template CDATA #IMPLIED>
Průvodce, který může sloužit k vytvoření nového rozšíření v editoru manifestu modulu plug-in.
- 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.IExtensionWizard. Tento atribut je vzájemně výlučný s atributem
template
.
- availableAsShortcut - Je-li nastavena hodnota true, zobrazí se tento průvodce v nabídce zástupce na panelu nabídek a panelu nástrojů.
- category - Nepovinné ID, které určuje, že je tento průvodce členem dříve definované kategorie. Má-li kategorie hierarchickou strukturu, měla by být pomocí oddělovače '/' zadána úplná cesta k nadřazené kategorii.
- template - Identifikátor šablony deklarované na jiném místě pomocí bodu rozšíření
org.eclipse.pde.ui.templates
. Je-li definován, bude vyhledána šablona se zadaným ID a pomocí šablony bude vytvořen průvodce rozšířením. Tento atribut je vzájemně výlučný s atributem class
.
<!ELEMENT editorWizard (description?)>
<!ATTLIST editorWizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED>
Průvodce, který může sloužit k úpravě stávajícího rozšíření v editoru manifestu modulu plug-in.
- 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.IExtensionEditorWizard.
- point - Úplný identifikátor bodu rozšíření, který je možné upravit pomocí tohoto průvodce.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- ID - Jedinečný název, který bude použit k identifikaci této kategorie.
- name - Přeložitelný název, který bude použit v prezentaci uživatelského rozhraní této kategorie.
- parentCategory - Nepovinný atribut, který je možné použít k vytvoření hierarchické struktury kategorií.
<!ELEMENT description (#PCDATA)>
Krátký popis tohoto průvodce.
Příklady:
Zde je uveden příklad rozšíření:
<extension
point=
"org.eclipse.pde.ui.newExtension"
>
<category
name=
"Custom Extensions"
id=
"custom"
>
</category>
<wizard
availableAsShortcut=
"true"
name=
"Simple Java Editor Extension"
icon=
"icons/java_edit.gif"
category=
"generic"
class=
"com.example.xyz.SimpleJavaEditorExtension"
id=
"com.example.xyz.simple"
>
<description>
Tento průvodce vytvoří jednoduchý editor jazyka Java
se všemi povinnými třídami a značkou manifestu.
</description>
</wizard>
</extension>
Informace rozhraní API:
Tento bod rozšíření vyžaduje třídu, která implementuje rozhraní org.eclipse.pde.ui.IExtensionWizard.
Dodaná implementace:
Prostředí PDE poskytuje obecného průvodce, který vytváří body rozšíření na základě informací schématu bodů rozšíření. Kromě toho jsou všechny šablony registrované pomocí bodu rozšíření org.eclipse.pde.ui.templates
v uživatelském rozhraní prostředí PDE také zapojeny jako průvodci jednotlivých rozšíření.
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