Préférences

org.eclipse.core.runtime.preferences

3.0

Le point d'extension de préférences permet aux plug-ins d'ajouter de nouvelles portées de préférence au mécanisme de préférence d'Eclipse, ainsi que d'indiquer la classe à exécuter pour initialiser les valeurs de préférences par défaut.

<!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>

Elément décrivant la définition d'un client pour une nouvelle portée de préférence.



<!ELEMENT initializer EMPTY>

<!ATTLIST initializer

class CDATA #REQUIRED>

Elément définissant la classe à utiliser pour l'initialisation des préférences d'exécution.



<!ELEMENT modifier EMPTY>

<!ATTLIST modifier

class CDATA #REQUIRED>

Elément qui définit la classe à utiliser pour l'écoute de la modification des préférences.



L'exemple ci-dessous illustre la déclaration de la portée de préférence. Cet exemple déclare que ce plug-in fournira une implémentation de préférence pour la portée "foo". Il déclare également qu'au chargement des valeurs par défaut pour ce plug-in, la classe "MyPreferenceInitializer" contient du code à exécuter afin d'initialiser les valeurs par défaut des préférences.

      

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

Le service de préférence (disponible en appelant org.eclipse.core.runtime.Platform.getPreferencesService()) est le point d'ancrage dans le mécanisme de préférence d'Eclipse.

Le plug-in org.eclipse.core.runtime fournit des implémentations de préférences pour les portées "configuration", "instance" et "default". Le plug-in org.eclipse.core.resources fournit une implémentation pour les préférences "project".