Przeglądarka
Identyfikator:
org.eclipse.help.base.browser
Dostępne od wersji:
3.0 (punkt rozszerzenia początkowo dodany do wersji
2.0 jako org.eclipse.help.ui.browser)
Opis:
Punkt rozszerzenia służący do udostępniania przeglądarek WWW,
które mogą wyświetlać dokumenty HTML o podanym adresie URL.Uwaga: Począwszy od wersji 3.1 system pomocy korzysta z funkcji obsługi przeglądarki środowiska roboczego (patrz sekcja org.eclipse.ui.browserSupport
). Opisany w tym dokumencie punkt rozszerzenia pozostaje dostępny tylko w celu użycia przez autonomiczny system pomocy. Adaptery przeglądarek niestandardowych, które muszą pracować w trybie środowiska roboczego, powinny zostać przeniesione do punktu rozszerzenia środowiska roboczego.
Znaczniki konfiguracji:
<!ELEMENT extension (browser*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT browser (factoryclass)>
<!ATTLIST browser
id CDATA #REQUIRED
factoryclass CDATA #IMPLIED
name CDATA #REQUIRED>
- id - unikalny identyfikator przeglądarki.
- factoryclass - klasa implementacji dla fabryki przeglądarki. Klasa
ta musi implementować interfejs
org.eclipse.help.browser.IBrowserFactory. Istnieje możliwość
pominięcia tego atrybutu i posłużenia się w zamian zagnieżdżonym elementem
factoryclass.
- name - nazwa przeglądarki (możliwa do przetłumaczenia).
<!ELEMENT factoryclass (parameter*)>
<!ATTLIST factoryclass
class CDATA #REQUIRED>
- class - klasa implementacji dla fabryki przeglądarki. Klasa ta musi
implementować interfejs org.eclipse.help.browser.IBrowserFactory.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - nazwa parametru przekazywana do klasy implementacji.
- value - wartość parametru przekazywana do klasy implementacji.
Przykłady:
Oto przykładowe użycie punktu rozszerzenia
przeglądarki:
<extension point=
"org.eclipse.help.base.browser"
>
<browser
id=
"org.eclipse.myPlugin.myBrowserID"
factoryClass=
"org.eclipse.myPlugin.myPackage.MyFactoryClass"
name=
"My Browser"
>
</browser>
</extension>
Informacje o interfejsie API:
Klasa ta musi implementować interfejs
org.eclipse.help.browser.IBrowserFactory. Metody w tym interfejsie
decydują o tym, czy fabryka będzie dostępna w danym systemie (tzn. czy będzie w
stanie dostarczać instancje przeglądarek), a także tworzą instancje
przeglądarek implementujące interfejs IBrowser.
Dostarczana implementacja:
Moduły dodatkowe
org.eclipse.help.base oraz org.eclipse.help.ui
zawierają implementacje przeglądarek na typowych platformach. Inne moduły
dodatkowe mogą udostępniać inne implementacje. Użytkownik może w ramach
preferencji wybrać domyślną przeglądarkę spośród dostępnych przeglądarek.
Copyright (c) 2000, 2005 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.