Plugin-indholdsguider
Id:
org.eclipse.pde.ui.pluginContent
Beskrivelse:
Dette udvidelsespunkt er beregnet på at bidrage med guider, der opretter yderligere indhold til PDE-plugin-projekter. Når plugin-manifest og nøglefiler er oprettet, kan guiderne bruges til at tilføje flere filer og udvidelser til den oprindelige struktur. En typisk implementering af denne guide tilføjer indhold baseret på en skabelon med parametre, som er tilpasset på baggrund af brugerens valg i guiden.
Målet er en plugin, der udfører noget praktisk lige efter oprettelsen (f.eks. bidrager med en oversigt, en editor, eller lignende).
Konfigurationskode:
<!ELEMENT extension (wizard*)>
<!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 #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 - 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.IPluginContentWizard.
- category - en valgfri kode, som kan bruges til at knytte indholdsguider sammen med forskellige målprojekter.
- ui-content - en markering, som angiver, om guiden bidrager kode med brugergrænsefladeindhold. Denne markering har indflydelse på, hvilken plugin-klasse der senere vælges (UI-plugins udvider klassen
AbstractUIPlugin
, mens ikke-UI-plugins udvider basisklassen Plugin
). Da mange bidrag til Eclipse har UI-indhold, er denne attribut som standard true
.
- java - en markering, som angiver, at guiden bidrager med Java-indhold. Da de fleste Eclipse-plugins har Java-kode, er attributten som standard
true
. Angiv den somfalse
, hvis en plugin ikke indeholder Java-kode (f.eks. rene dokumentationsfiler).
- rcp - Siden 3.1. En boolesk markering, som angiver, om guiden bidrager med et enkeltstående 'rich client'-program med alle funktioner. Hvis der angives
true
, vises guiden kun i guiden Ny plugin-guide, hvis brugeren vælger punktet Rich Client Application.
- pureOSGi - Fra 3.2. Et boolesk flag, der angiver, om guiden bidrager med et rent OSGi-bundt. Hvis der angives
true
, vises guiden kun i guiden Nyt plugin-projekt, hvis brugeren vælger at oprette et rent OSGi-bundt.
- requiresActivator - Fra 3.2. Et boolesk flag, der angiver, om guiden bidrager med en aktivatorklasse. Hvis der angives
true
, vises guiden kun i guiden Nyt plugin-projekt, hvis brugeren vælger at generere en aktivator, der skal styre plugin'ens livscyklus.
<!ELEMENT description (#PCDATA)>
Kort beskrivelse af guiden.
Eksempler:
Følgende er et eksempel på dette udvidelsespunkt:
<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>
Tilføjer en oversigt og en indstillingsside.
</description>
</wizard>
</extension>
API-oplysninger:
Guider, der 'plugger ind' i dette udvidelsespunkt, skal implementere grænsefladen org.eclipse.pde.ui.IPluginContentWizard
og forventes at udvide org.eclipse.jface.wizard.Wizard
.
Leveret implementering:
PDE indeholder API'er til bidrag af indholdsguider baseret på skabeloner, der kan tilpasses. PDE UI bidrager selv med et antal konkrete guider, som er baseret på disse skabeloner.
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.