Strony preferencji

org.eclipse.ui.preferencePages

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.

<!ELEMENT extension (page*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT page (keywordReference*)>

<!ATTLIST page

id       CDATA #REQUIRED

name     CDATA #REQUIRED

class    CDATA #REQUIRED

category CDATA #IMPLIED>


<!ELEMENT keywordReference EMPTY>

<!ATTLIST keywordReference

id CDATA #REQUIRED>

Odwołanie strony preferencji do słowa kluczowego. Patrz opis punktu rozszerzenia słów kluczowych.



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>

Wartość atrybutu class musi reprezentować pełną nazwą klasy implementującej interfejs org.eclipse.ui.IWorkbenchPreferencePage.

Ś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.