Kreatory treści wtyczek
Identyfikator:
org.eclipse.pde.ui.pluginContent
Opis:
Ten punkt rozszerzenia
umożliwia dodawanie kreatorów tworzących dodatkową treść projektów wtyczek w środowisku PDE. Po utworzeniu plików manifestu i kluczy można
użyć tych kreatorów w celu dodania kolejnych plików i rozszerzeń do struktury
początkowej. Typowa implementacja tego kreatora dodaje treść na podstawie
parametryzowanego szablonu dostosowanego w oparciu o wybory użytkownika
dokonywane w kreatorze.
Celem jest napisanie wtyczki, która robi coś użytecznego bezpośrednio po utworzeniu (na przykład dodaje widok, edytor itp.).
Znaczniki konfiguracji:
<!ELEMENT extension (wizard*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - pełny identyfikator docelowego punktu rozszerzenia.
- id - opcjonalny identyfikator instancji rozszerzenia.
- name - opcjonalna nazwa instancji rozszerzenia.
<!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 - unikalna nazwa, która będzie używana do identyfikowania tego
kreatora.
- name - możliwa do przetłumaczenia nazwa, która będzie używana do prezentacji tego
kreatora w interfejsie użytkownika.
- icon - względna ścieżka do pliku ikony, która będzie wizualnie
reprezentowała kreatora.
- class - pełna nazwa klasy, która implementuje interfejs org.eclipse.pde.ui.IPluginContentWizard.
- category - opcjonalny znacznik, którego można użyć do powiązania
kreatorów treści z różnymi projektami docelowymi.
- ui-content - flaga wskazująca, czy kreator doda kod z treścią
interfejsu użytkownika. Ta flaga będzie miała wpływ na wybór klasy wtyczki, ponieważ wtyczki interfejsu użytkownika rozszerzają
klasę
AbstractUIPlugin
, natomiast inne wtyczki
rozszerzają klasę podstawową Plugin
. Ponieważ wiele
elementów dodanych do platformy
Eclipse rozszerza treść interfejsu użytkownika, domyślna wartość tego atrybutu
wynosi true
.
- java - flaga wskazująca, że kreator doda treść Java. Ponieważ
większość wtyczek dla platformy Eclipse zawiera kod Java,
wartość domyślna tego atrybutu wynosi
true
. Argumentowi należy
nadać wartość false
, gdy wtyczka nie zawiera kodu Java (na
przykład pliki zawierające wyłącznie dokumentację).
- rcp - dostępne od wersji 3.1. Flaga boolowska wskazująca, czy kreator udostępnia autonomiczną, w pełni funkcjonalną aplikację pełnego klienta. Jeśli flaga jest ustawiona na wartość
true
, kreator będzie wyświetlany w kreatorze Nowy projekt wtyczki tylko wtedy, gdy użytkownik wybierze opcję Aplikacja pełnego klienta.
- pureOSGi (od wersji 3.2) to flaga typ boolowskiego wskazująca, czy kreator wnosi czysty pakunek OSGi. Jeśli ustawiona wartość flagi to
true
, kreator jest wyświetlany w narzędziu Nowy projekt wtyczki wyłącznie jeśli użytkownik wybrał opcję tworzenia czystego pakunku OSGi.
- requiresActivator (od wersji 3.2) to flaga typu boolowskiego wskazująca, czy kreator wnosi klasę aktywatora. Jeśli ustawiona wartość flagi to
true
, kreator jest wyświetlany w kreatorze Nowy projekt wtyczki wyłącznie jeśli użytkownik wybrał opcję generowania aktywatora kontrolującego cykl życia wtyczki.
<!ELEMENT description (#PCDATA)>
Krótki opis tego kreatora.
Przykłady:
Poniżej przedstawiono przykład tego punktu rozszerzenia:
<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>
Dodaje widok i stronę preferencji.
</description>
</wizard>
</extension>
Informacje o interfejsie API:
Kreatory podłączane do tego punktu rozszerzenia muszą implementować interfejs
org.eclipse.pde.ui.IPluginContentWizard oraz rozszerzać klasę org.eclipse.jface.wizard.Wizard
.
Dostarczana implementacja:
W
środowisku PDE dostępne są interfejsy API, które służą do dodawania kreatorów
treści na podstawie szablonów, które można dostosowywać. Samo środowisko
PDE dodaje szereg konkretnych kreatorów utworzonych w oparciu o te szablony.
Copyright (c) 2004 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach
licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i
dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.