Ostatnia aktualizacja: 25 marca 2003 (na potrzeby platformy Eclipse 2.1)
Informacje o konkretnym składniku są wyświetlane na podstawie właściwości określonych w pliku "about.ini
", który znajduje się w module dodatkowym danego składnika.
Jest to plik w formacie java.io.Properties (kodowanie znaków ISO 8859-1, znaki zmiany znaczenia Unicode: \uxxxx). Plik zawiera następujące klucze:
aboutText
" - złożony z wielu wierszy opis składnika zawierający informacje o prawach autorskich, warunki licencji, informacje o rejestracji licencji itp.
Umieszczone w tekście adresy URL są prezentowane jako odsyłacze. Koniec wiersza jest oznaczany symbolem "\n
". Wiersze nie powinny mieć więcej niż 75 znaków, a liczba wierszy jest ograniczona do 15. Informacje są wyświetlane w głównym oknie dialogowym "Informacje o" (razem z obrazem o połowicznej wielkości) oraz w dodatkowym oknie dialogowym "Informacje o" opisującym poszczególne składniki. Ta właściwość musi być określona w przypadku wszystkich składników. windowImage
" - kolorowy obraz o wielkości 16x16 piksli używany do oznaczania okien generowanych przez dany produkt. Wartością tej właściwości jest ścieżka do pliku obrazu określona względem katalogu modułu dodatkowego. Ta właściwość jest wymagana tylko dla składników podstawowych, a w przypadku pozostałych składników można ją pominąć. featureImage
" - kolorowy obraz o wielkości 32x32 piksli używany jako ikona danego składnika. Wartością tej właściwości jest ścieżka do pliku obrazu określona względem katalogu modułu dodatkowego. Obraz ten jest wyświetlany w oknie dialogowym "Informacje o" z opisem poszczególnych składników, a także w głównym oknie dialogowym "Informacje o", gdzie jego użycie oznacza obecność danego składnika. Ta właściwość jest opcjonalna. Pokrewne składniki, dostarczone przez jednego dostawcę, powinny zawierać kopie tego samego pliku graficznego, ponieważ pozwala to wyeliminować powielanie jednakowych obrazów. aboutImage
" - duży, kolorowy obraz wyświetlany w głównym oknie dialogowym "Informacje o" produktu. Wartością tej właściwości jest ścieżka do pliku obrazu określona względem katalogu modułu dodatkowego. Ta właściwość jest wymagana tylko dla składników podstawowych, a w przypadku pozostałych składników należy ją pominąć. W zależności od wielkości obrazu dopuszczalne jest stosowanie układu z obrazem i tekstem lub układu, który zawiera tylko tekst. Obraz o połowicznej wielkości (maksymalnie 250 piksli szerokości i 330 piksli wysokości) jest wyświetlany w głównym oknie dialogowym "Informacje o" razem z tekstem określonym przy użyciu właściwości "aboutText
". Obraz o pełnej wielkości (maksymalnie 500 piksli szerokości i 330 piksli wysokości) jest wyświetlany bez tekstu. welcomePage
" - strona powitania. Wartością tej właściwości jest ścieżka do pliku XML ze stroną powitania składnika, określona względem katalogu modułu dodatkowego. Ta właściwość jest zalecana dla wszystkich składników podstawowych, a w przypadku pozostałych składników można ją pominąć. welcomePerspective
" - preferowana perspektywa stosowana przy wyświetlaniu strony powitania. Wartością tej właściwości jest identyfikator perspektywy środowiska roboczego. Ta właściwość jest zalecana w przypadku składników ze stronami powitania, które powinny być wyświetlane w kontekście widoków i edytorów danego składnika. W przypadku składników pozbawionych stron powitania lub składników, w przypadku których miejsce wyświetlania strony powitania nie ma znaczenia, tę właściwość należy pominąć. appName
" - krótki, nietłumaczony łańcuch umożliwiający powiązanie nazwy z aplikacją na platformach, w przypadku których ma to znaczenie. W środowiskach operacyjnych z systemem okienkowym Motif ta wartość jest używana do wyszukiwania zasobu Motif (patrz xrdb i pojęcia pokrewne). W menedżerze okien CDE (używanym w systemach Solaris i AIX) ta nazwa jest wyświetlana poniżej ikon oznaczających zminimalizowane okna znajdujące się na pulpicie. Ta właściwość jest wymagana dla składników podstawowych, a w przypadku pozostałych składników można ją pominąć. tipsAndTricksHref
" - sekcja wskazówek w dokumentacji pomocy. Wartością tej właściwości jest odwołanie do podręcznika pomocy zawierającego sekcję ze wskazówkami dotyczącymi danego składnika (np. tipsAndTricksHref=/org.eclipse.jdt.doc.user/tips/jdt_tips.html
).
Ta właściwość jest zalecana dla wszystkich składników podstawowych, a w przypadku pozostałych składników można ją pominąć.