Kreatorzy treści modułów dodatkowych
Identyfikator:
org.eclipse.pde.ui.pluginContent
Opis:
Ten punkt rozszerzenia
umożliwia dodawanie kreatorów tworzących dodatkową treść projektów modułów
dodatkowych 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 modułu dodatkowego, który 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">
- 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 modułu
dodatkowego, ponieważ moduły dodatkowe interfejsu użytkownika rozszerzają
klasę
AbstractUIPlugin, natomiast inne moduły dodatkowe
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ść modułów dodatkowych dla platformy Eclipse zawiera kod Java,
wartość domyślna tego atrybutu wynosi
true. Argumentowi należy
nadać wartość false, gdy moduł dodatkowy 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 modułu dodatkowego tylko wtedy, gdy użytkownik wybierze opcję Aplikacja pełnego klienta.
<!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:
Kreatorzy podłączani 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.