Preferencje

org.eclipse.core.runtime.preferences

3.0

Punkt rozszerzenia preferencji umożliwia wtyczkom dodawanie nowych zasięgów preferencji do mechanizmu preferencji środowiska Eclipse, a także określanie klasy, która ma być uruchamiana w celu zainicjowania domyślnych wartości preferencji w środowisku uruchamiania.

<!ELEMENT extension (scope* , initializer* , modifier*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT scope EMPTY>

<!ATTLIST scope

name  CDATA #REQUIRED

class CDATA #REQUIRED>

Element opisujący definicję nowego zasięgu preferencji klienta.



<!ELEMENT initializer EMPTY>

<!ATTLIST initializer

class CDATA #REQUIRED>

Element definiujący klasę, która ma być używana do inicjowania preferencji środowiska wykonawczego.



<!ELEMENT modifier EMPTY>

<!ATTLIST modifier

class CDATA #REQUIRED>

Element definiujący klasę, która ma być używana do nasłuchiwania modyfikacji preferencji.



Poniżej przedstawiono przykładową deklarację zasięgu preferencji. W tym przykładzie zadeklarowano, że wtyczka udostępni implementację preferencji dla zasięgu foo. Zadeklarowano także, że po załadowaniu wartości domyślnych tej wtyczki klasa MyPreferenceInitializer będzie zawierała kod, który ma zostać uruchomiony w celu zainicjowania domyślnych wartości preferencji w środowisku wykonawczym.

      

<extension point=

"org.eclipse.core.runtime.preferences"

>

<scope name=

"foo"

class=

"com.example.FooPrefs"

/>

<initializer class=

"com.example.MyPreferenceInitializer"

/>

<modifier class=

"com.example.MyModifyListener"

/>

</extension>

Usługa preferencji (uzyskiwana przez wywołanie klasy org.eclipse.core.runtime.Platform.getPreferencesService()) stanowi hak do mechanizmu preferencji środowiska Eclipse.

Wtyczka org.eclipse.core.runtime udostępnia implementacje preferencji dla zasięgu konfiguracji, zasięgu instancji i zasięgu domyślnego. Wtyczka org.eclipse.core.resources udostępnia implementację preferencji projektu.