# Language Settings Provider UI Associations

###### Identifier:

org.eclipse.cdt.ui.LanguageSettingsProviderAssociation

###### Since:

CDT 8.1

###### Description:

This extension point defines appearance and behavior of UI controls for Language Settings Providers defined with extension point `org.eclipse.cdt.core.LanguageSettingsProvider`.

###### Configuration Markup:

<!ELEMENT extension (id-association* , class-association*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

This extension point is used to define appearance and behavior of Language Settings Providers in user interface.

- id - ID of the extension point, not used
- name - Name of the extension point, not used

<!ELEMENT id-association EMPTY>

<!ATTLIST id-association

id CDATA #REQUIRED

icon CDATA #IMPLIED

page CDATA #IMPLIED

ui-edit-entries (true | false)

ui-clear-entries (true | false) >

The definition of UI elements associated with ID of language settings provider.

- id - ID of language settings provider for which appearance is being defined.
- icon - The path to the provider icon in the defining plugin, for example icons/obj16/picture.gif.
- page - Options page for the provider to appear in preferences in Providers tab.
- ui-edit-entries - Defines if user is allowed to edit provider's entries in UI.
- ui-clear-entries - Defines if user is allowed to clear provider's entries in UI. For some providers like compiler specs detectors that may trigger automatic rerun.

<!ELEMENT class-association EMPTY>

<!ATTLIST class-association

class CDATA #REQUIRED

icon CDATA #IMPLIED

page CDATA #IMPLIED

ui-edit-entries (true | false)

ui-clear-entries (true | false) >

The definition of UI elements associated with type of language settings provider. Providers subclassed from this type will inherit characteristics from closest super-type (unless exact ID association is defined).

- class - Class of language settings provider for which appearance is being defined.
- icon - The path to the provider icon in the defining plugin, for example `icons/obj16/picture.gif`.
- page - Options page for the provider to appear in preferences in Providers tab.
- ui-edit-entries - Defines if user is allowed to edit provider's entries in UI.
- ui-clear-entries - Defines if user is allowed to clear provider's entries in UI. For some providers like compiler specs detectors that may trigger automatic rerun.

###### Examples:

For an example see definition for org.eclipse.cdt.ui.UserLanguageSettingsProvider.

Copyright (c) 2010, 2012 Andrew Gvozdev and others. This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/ SPDX-License-Identifier: EPL-2.0