Preferências

org.eclipse.core.runtime.preferences

3.0

O ponto de extensão de preferências permite a plug-ins adicionar novos âmbitos de preferência ao mecanismo de preferência Eclipse, bem como especificar a classe a executar para inicializar os valores de preferência predefinidos no tempo de execução.

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

Elemento que descreve uma definição de um novo âmbito de preferências de um cliente.



<!ELEMENT initializer EMPTY>

<!ATTLIST initializer

class CDATA #REQUIRED>

Elemento que define a classe a utilizar para a inicialização de preferências de tempo de execução.



<!ELEMENT modifier EMPTY>

<!ATTLIST modifier

class CDATA #REQUIRED>

Elemento que define a classe a utilizar para a recepção de modificação de preferências.



De seguida é apresentado um exemplo de uma declaração de âmbito de preferências. Este exemplo declara que este plug-in irá facultar uma implementação de preferências para o âmbito "foo". Também declara que quando os valores predefinidos são carregados para este plug-in, a classe "MyPreferenceInitializer" contém um código a executar para inicializar os valores predefinidos de preferências no tempo de execução.

      

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

O serviço de preferências (obtido chamando org.eclipse.core.runtime.Platform.getPreferencesService()) é a ligação ao mecanismo de preferências Eclipse.

O plug-inorg.eclipse.core.runtime faculta implementações de preferências para âmbitos "configuration", "instance" e "default". O plug-in org.eclipse.core.resources faculta uma implementação para preferências "project".