Szablony rozszerzeń
Identyfikator:
org.eclipse.pde.ui.templates
Dostępne od wersji:
2.0
Opis:
Ten punkt rozszerzeń służy do
rejestrowania szablonów treści projektów modułów dodatkowych używanych do
generowania kodu nowych rozszerzeń. Szablony są używane w dwóch
przypadkach:
- Szablony są łączone w kreatorze dodawanym jako kreator treści modułów
dodatkowych przy użyciu punktu rozszerzenia
org.eclipse.pde.ui.pluginContent
. Szablony te tworzą treść dla nowo utworzonych projektów modułów
dodatkowych. Ponadto wszystkie szablony dodane przy użyciu tego punktu
rozszerzenia są dostępne w specjalnej wersji kreatora treści modułów
dodatkowych, który zawiera listę szablonów i umożliwia użytkownikom swobodne
łączenie szablonów przez zaznaczanie ich na liście.
- Używając szablonu, można dodać nowe rozszerzenie do istniejącego modułu dodatkowego.
Znaczniki konfiguracji:
<!ELEMENT extension (template+)>
<!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 template EMPTY>
<!ATTLIST template
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
contributingId CDATA #REQUIRED>
- id - unikalna nazwa, która będzie używana do identyfikowania tego szablonu.
- name - możliwa do przetłumaczenia nazwa, która będzie używana do prezentacji tego szablonu w interfejsie użytkownika.
- icon - względna ścieżka do pliku ikony, która będzie wizualnie reprezentowała szablon.
- class - pełna nazwa klasy, która implementuje interfejs
org.pde.ui.templates.ITemplateSection
.
- contributingId - identyfikator punktu rozszerzenia, do którego ten szablon będzie dodawał elementy.
Przykłady:
Poniżej przedstawiono przykład rejestracji szablonu:
<extension
point=
"org.eclipse.pde.ui.templates"
>
<template
contributingId=
"org.eclipse.ui.actionSets"
name=
"XYZ Action Set Generator"
class=
"com.example.xyz.XYZActionSetTemplate"
id=
"com.example.xyz.ActionSetTemplate"
>
</template>
</extension>
Informacje o interfejsie API:
Każdy
szablon musi udostępniać klasę, która implementuje interfejs org.eclipse.pde.ui.templates.ITemplateSection
. Dostępne są jednak klasy abstrakcyjne, które implementują ten interfejs i mogą być rozszerzane.
Dostarczana implementacja:
W
interfejsie użytkownika środowiska PDE dostępnych jest wiele szablonów,
które tworzą rozszerzenia dla najpopularniejszych punktów rozszerzeń, takich
jak edytory, widoki, preferencje itp.
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.