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 wtyczek 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 wtyczek przy użyciu punktu rozszerzenia
org.eclipse.pde.ui.pluginContent. Szablony te tworzą treść dla nowo utworzonych projektów wtyczek. Ponadto wszystkie szablony wniesione za pomocą tego punktu rozszerzenia są widoczne w specjalnej wersji kreatora treści wtyczek, który zawiera listę szablonów i umożliwia użytkownikom swobodne łączenie szablonów poprzez zaznaczanie ich na liście.
- Za pomocą szablonu do dotychczasowej wtyczki można dodać nowe rozszerzenie.
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.