Udvidelsesguider
Id:
org.eclipse.pde.ui.newExtension
Beskrivelse:
Dette udvidelsespunkt anvendes til at bidrage med guider, som skal bruges til at oprette og redigere nye udvidelser i PDE-plugin-manifesteditoren. Vha. guider kan der oprettes én eller flere udvidelser samtidigt og den kode, der er nødvendig for at
implementere disse udvidelser. Hvis en bidraget guide er specielt oprettet til et bestemt udvidelsespunkt, tilrådes det også at registrere en tilsvarende editorguide. Denne guide bruges til at redigere udvidelsespunktet i manifesteditoren, når det er oprettet i manifestfilen.
Konfigurationskode:
<!ELEMENT extension (wizard | category | editorWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
- point - en fuldstændig id for måludvidelsespunktet.
- id - en valgfri id for udvidelsesforekomsten.
- name - et valgfrit navn på udvidelsesforekomsten.
<!ELEMENT wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #IMPLIED
availableAsShortcut (true | false)
category IDREF #IMPLIED
template IDREF #IMPLIED
>
en guide, der kan bruges til at oprette en ny udvidelse inde fra plugin-manifesteditoren.
- id - et entydigt navn, som bruges til at identificere guiden.
- name - et konvertérbart navn, som bruges i UI-repræsentation af guiden.
- icon - en relativ sti til en ikon, som bruges til at repræsentere guiden visuelt.
- class - et fuldstændigt navn på en klasse, som implementerer grænsefladen org.eclipse.pde.ui.IExtensionWizard. Denne attribut udelukker gensidigt attributten
template
.
- availableAsShortcut - Hvis denne er true, vises guiden i genvejsmenuen på menulinjen og værktøjslinjen.
- category - en valgfri id, som gør guiden til et medlem af den tidligere definerede kategori. Hvis kategorien er hierarkisk, skal der angives en fuldstændig sti til den overordnede kategori, og '/' skal bruges som skilletegn.
- template - id på en skabelon, der er erklæret et andet sted vha. udvidelsespunktet
org.eclipse.pde.ui.templates
. Hvis id'en defineres, bliver skabelonen med den angivne id fundet, og udvidelsesguiden oprettes vha. skabelonen. Denne attribut udelukker gensidigt attributten class
.
<!ELEMENT editorWizard (description?)>
<!ATTLIST editorWizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED
>
en guide, der kan bruges til at redigere en ny udvidelse inde fra plugin-manifesteditoren.
- id - et entydigt navn, som bruges til at identificere guiden.
- name - et konvertérbart navn, som bruges i UI-repræsentation af guiden.
- icon - en relativ sti til en ikon, som bruges til at repræsentere guiden visuelt.
- class - et fuldstændigt navn på en klasse, som implementerer grænsefladen org.eclipse.pde.ui.IExtensionEditorWizard.
- point - en fuldstændig id for det udvidelsespunkt, som guiden kan redigere
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory IDREF #IMPLIED
>
- id - et entydigt navn, der bruges til at referere til denne category
- name - et konvertérbart navn, som bruges i UI-præsentation af denne kategori
- parentCategory - en valgfri attribut, der kan bruges til at oprette et kategori-hierarki
<!ELEMENT description (#PCDATA)>
En kort beskrivelse af guiden.
Eksempler:
Følgende er et eksempel på udvidelsen:
<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>
Denne guide opretter en enkel Java-editor med
alle de nødvendige klasser og manifestmarkeringer.
</description>
</wizard>
</extension>
API-oplysninger:
Dette udvidelsespunkt kræver en klasse, som implementer grænsefladen org.eclipse.pde.ui.IExtensionWizard.
Leveret implementering:
PDE omfatter en generisk guide, som opretter udvidelsespunkter på basis af oplysningerne i skemaet til udvidelsespunkter. Desuden inddrages alle skabeloner, som er registreret vha. udvidelsespunktetorg.eclipse.pde.ui.templates
i PDE UI, som individuelle udvidelsesguider.
Copyright (c) 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.