Strony preferencji
Identyfikator:
org.eclipse.ui.preferencePages
Opis:
W środowisku roboczym dostępne
jest jedno wspólne okno dialogowe preferencji. Ten punkt rozszerzenia umożliwia modułom dodatkowym dodawanie stron do okna dialogowego preferencji. Strony dodane w ten sposób są uwzględniane w oknie dialogowym preferencji po
jego otwarciu (czynność inicjowana przy użyciu menu).
Okno dialogowe preferencji umożliwia hierarchiczne grupowanie stron. Z tego
powodu w przypadku tej strony można opcjonalnie określić atrybut category.
Atrybut ten reprezentuje ścieżkę złożoną z identyfikatorów stron nadrzędnych (oddzielonych znakiem /). Jeśli atrybut ten pominięto lub nie można znaleźć dowolnego z węzłów nadrzędnych w ścieżce, strona zostanie dodana na
poziomie głównym.
Znaczniki konfiguracji:
<!ELEMENT extension (page*)>
<!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 page (keywordReference*)>
<!ATTLIST page
id CDATA #REQUIRED
name CDATA #REQUIRED
class CDATA #REQUIRED
category CDATA #IMPLIED>
- id - unikalna nazwa, która będzie używana do identyfikowania tej
strony.
- name - możliwa do przetłumaczenia nazwa, która będzie oznaczać tę
stronę w interfejsie użytkownika.
- class - pełna nazwa klasy implementującej interfejs
org.eclipse.ui.IWorkbenchPreferencePage.
- category - ścieżka wskazująca położenie strony w drzewie
preferencji. Ścieżka może być identyfikatorem węzła nadrzędnego lub sekwencją
identyfikatorów oddzielonych znakiem /, które reprezentują pełną ścieżkę (rozpoczynając od węzła głównego).
<!ELEMENT keywordReference EMPTY>
<!ATTLIST keywordReference
id CDATA #REQUIRED>
Odwołanie strony preferencji do słowa kluczowego. Patrz opis punktu rozszerzenia słów kluczowych.
- id - identyfikator przywoływanego słowa kluczowego.
Przykłady:
Poniżej przedstawiono
przykład punktu rozszerzenia preferencji:
<extension
point=
"org.eclipse.ui.preferencePages"
>
<page
id=
"com.xyz.prefpage1"
name=
"XYZ"
class=
"com.xyz.prefpages.PrefPage1"
>
<keywordReference id=
"xyz.Keyword"
/>
</page>
<page
id=
"com.xyz.prefpage2"
name=
"Ustawienia klawiatury"
class=
"com.xyz.prefpages.PrefPage2"
category=
"com.xyz.prefpage1"
>
</page>
</extension>
Informacje o interfejsie API:
Wartość
atrybutu class musi reprezentować pełną nazwą klasy implementującej interfejs
org.eclipse.ui.IWorkbenchPreferencePage.
Dostarczana implementacja:
Środowisko
robocze dodaje kilka stron, które umożliwiają ustawianie preferencji platformy. Strony zarejestrowane przez to rozszerzenie zostaną dodane po nich zgodnie z informacjami dotyczącymi kategorii.
Copyright (c) 2002, 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.