Kreatory rozszerzeń
Identyfikator:
org.eclipse.pde.ui.newExtension
Opis:
Ten punkt rozszerzenia służy
do dodawania kreatorów, którzy będą używani do edytowania nowych rozszerzeń w
edytorze manifestów wtyczek w środowisku PDE. Kreatory mogą
tworzyć kilka rozszerzeń jednocześnie oraz kod potrzebny do implementacji tych
rozszerzeń. Gdy dodawany kreator został specjalnie utworzony dla konkretnego
punktu rozszerzenia, zaleca się zarejestrowanie także odpowiedniego kreatora
edytorów. Ten kreator zostanie użyty do edycji punktu rozszerzenia w
edytorze manifestów po utworzeniu tego punktu w pliku manifestu.
Znaczniki konfiguracji:
<!ELEMENT extension (wizard | category | editorWizard)*>
<!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 #IMPLIED
availableAsShortcut (true | false)
category CDATA #IMPLIED
template CDATA #IMPLIED>
Kreator, którego można użyć do utworzenia nowego rozszerzenia z poziomu edytora manifestów wtyczek.
- 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.pde.ui.IExtensionWizard. Ten atrybut i atrybut
template
wzajemnie się wykluczają.
- availableAsShortcut - gdy ma wartość true, ten
kreator będzie dostępny w menu skrótów paska menu i paska narzędzi.
- category - opcjonalny identyfikator, który wiąże tego kreatora ze
zdefiniowaną wcześniej kategorią. Gdy kategorie mają strukturę hierarchiczną,
należy podać pełną ścieżkę, używając znaku '/' jako separatora.
- template - identyfikator szablonu zadeklarowanego w innym miejscu
przy użyciu punktu rozszerzenia
org.eclipse.pde.ui.templates
.
Zdefiniowanie tego atrybutu spowoduje odszukanie szablonu o określonym
identyfikatorze i użycie go podczas tworzenia kreatora rozszerzeń. Ten atrybut
i atrybut class
wzajemnie się wykluczają.
<!ELEMENT editorWizard (description?)>
<!ATTLIST editorWizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED>
Kreator, którego można użyć do edycji istniejącego rozszerzenia z poziomu edytora
manifestów wtyczek.
- 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.pde.ui.IExtensionEditorWizard.
- point - pełny identyfikator punktu rozszerzenia, który może być
edytowany przez tego kreatora.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - unikalna nazwa, która będzie używana w odwołaniach do tej kategorii.
- name - możliwa do przetłumaczenia nazwa, która będzie używana do prezentacji tej
kategorii w interfejsie użytkownika.
- parentCategory - opcjonalny atrybut, którego można używać, aby
utworzyć hierarchię kategorii.
<!ELEMENT description (#PCDATA)>
Krótki opis tego kreatora.
Przykłady:
Poniżej przedstawiono przykład rozszerzenia:
<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>
Ten kreator tworzy prosty edytor Java wraz z
wszystkimi wymaganymi klasami i znacznikami manifestu.
</description>
</wizard>
</extension>
Informacje o interfejsie API:
Ten punkt rozszerzenia wymaga klasy, która implementuje interfejs org.eclipse.pde.ui.IExtensionWizard.
Dostarczana implementacja:
W
środowisku PDE jest dostępny ogólny kreator, który tworzy punkty
rozszerzeń na podstawie informacji ze schematu punktu rozszerzenia. Ponadto
wszystkie szablony zarejestrowane przy użyciu punktu rozszerzenia
org.eclipse.pde.ui.templates
w interfejsie użytkownika środowiska PDE są także podłączane jako kreatory poszczególnych rozszerzeń.
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.