org.eclipse.jface.preference
Class PreferenceConverter

java.lang.Object
  |
  +--org.eclipse.jface.preference.PreferenceConverter

public class PreferenceConverter

extends Object

A utility class for dealing with preferences whose values are common SWT objects (color, points, rectangles, and font data). The static methods on this class handle the conversion between the SWT objects and their string representations.

Usage:

 IPreferenceStore store = ...;
 PreferenceConverter.setValue(store, "bg", new RGB(127,127,127));
 ...
 RBG bgColor = PreferenceConverter.getValue(store, "bg");
 

This class contains static methods and fields only and cannot be instantiated.

Field Summary

static RGB	COLOR_DEFAULT_DEFAULT The default-default value for color preferences (black, RGB(0,0,0)).
static FontData[]	FONTDATA_ARRAY_DEFAULT_DEFAULT The default-default value for FontData preferences.
static FontData	FONTDATA_DEFAULT_DEFAULT The default-default value for FontData preferences.
static Point	POINT_DEFAULT_DEFAULT The default-default value for point preferences (the origin, (0,0)).
static Rectangle	RECTANGLE_DEFAULT_DEFAULT The default-default value for rectangle preferences (the empty rectangle (0,0,0,0)).

Method Summary

static RGB	getColor(IPreferenceStore store, String name) Returns the current value of the color-valued preference with the given name in the given preference store.
static RGB	getDefaultColor(IPreferenceStore store, String name) Returns the default value for the color-valued preference with the given name in the given preference store.
static FontData	getDefaultFontData(IPreferenceStore store, String name) Returns a single default value for the font-valued preference with the given name in the given preference store.
static FontData[]	getDefaultFontDataArray(IPreferenceStore store, String name) Returns the default value array for the font-valued preference with the given name in the given preference store.
static Point	getDefaultPoint(IPreferenceStore store, String name) Returns the default value for the point-valued preference with the given name in the given preference store.
static Rectangle	getDefaultRectangle(IPreferenceStore store, String name) Returns the default value for the rectangle-valued preference with the given name in the given preference store.
static FontData	getFontData(IPreferenceStore store, String name) Returns the current value of the first entry of the font-valued preference with the given name in the given preference store.
static FontData[]	getFontDataArray(IPreferenceStore store, String name) Returns the current value of the font-valued preference with the given name in the given preference store.
static Point	getPoint(IPreferenceStore store, String name) Returns the current value of the point-valued preference with the given name in the given preference store.
static Rectangle	getRectangle(IPreferenceStore store, String name) Returns the current value of the rectangle-valued preference with the given name in the given preference store.
static void	setDefault(IPreferenceStore store, String name, FontData value) Sets the default value of the preference with the given name in the given preference store.
static void	setDefault(IPreferenceStore store, String name, FontData[] value) Sets the default value of the preference with the given name in the given preference store.
static void	setDefault(IPreferenceStore store, String name, Point value) Sets the default value of the preference with the given name in the given preference store.
static void	setDefault(IPreferenceStore store, String name, Rectangle value) Sets the default value of the preference with the given name in the given preference store.
static void	setDefault(IPreferenceStore store, String name, RGB value) Sets the default value of the preference with the given name in the given preference store.
static void	setValue(IPreferenceStore store, String name, FontData value) Sets the current value of the preference with the given name in the given preference store.
static void	setValue(IPreferenceStore store, String name, FontData[] value) Sets the current value of the preference with the given name in the given preference store.
static void	setValue(IPreferenceStore store, String name, Point value) Sets the current value of the preference with the given name in the given preference store.
static void	setValue(IPreferenceStore store, String name, Rectangle value) Sets the current value of the preference with the given name in the given preference store.
static void	setValue(IPreferenceStore store, String name, RGB value) Sets the current value of the preference with the given name in the given preference store.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

POINT_DEFAULT_DEFAULT

public static final Point POINT_DEFAULT_DEFAULT

The default-default value for point preferences (the origin, (0,0)).

RECTANGLE_DEFAULT_DEFAULT

public static final Rectangle RECTANGLE_DEFAULT_DEFAULT

The default-default value for rectangle preferences (the empty rectangle (0,0,0,0)).

COLOR_DEFAULT_DEFAULT

public static final RGB COLOR_DEFAULT_DEFAULT

The default-default value for color preferences (black, RGB(0,0,0)).

FONTDATA_ARRAY_DEFAULT_DEFAULT

public static final FontData[] FONTDATA_ARRAY_DEFAULT_DEFAULT

The default-default value for FontData preferences.

FONTDATA_DEFAULT_DEFAULT

public static final FontData FONTDATA_DEFAULT_DEFAULT

The default-default value for FontData preferences. This is left in for compatibility purposes. It is recommended that FONTDATA_ARRAY_DEFAULT_DEFAULT is actually used.

Method Detail

getColor

public static RGB getColor(IPreferenceStore store,
                           String name)

Returns the current value of the color-valued preference with the given name in the given preference store. Returns the default-default value (COLOR_DEFAULT_DEFAULT) if there is no preference with the given name, or if the current value cannot be treated as a color.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the color-valued preference

getDefaultColor

public static RGB getDefaultColor(IPreferenceStore store,
                                  String name)

Returns the default value for the color-valued preference with the given name in the given preference store. Returns the default-default value (COLOR_DEFAULT_DEFAULT) is no default preference with the given name, or if the default value cannot be treated as a color.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the default value of the preference

getDefaultFontDataArray

public static FontData[] getDefaultFontDataArray(IPreferenceStore store,
                                                 String name)

Returns the default value array for the font-valued preference with the given name in the given preference store. Returns the default-default value (FONTDATA_ARRAY_DEFAULT_DEFAULT) is no default preference with the given name, or if the default value cannot be treated as font data.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the default value of the preference

getDefaultFontData

public static FontData getDefaultFontData(IPreferenceStore store,
                                          String name)

Returns a single default value for the font-valued preference with the given name in the given preference store. Returns the default-default value (FONTDATA_DEFAULT_DEFAULT) is no default preference with the given name, or if the default value cannot be treated as font data. This method is provided for backwards compatibility. It is recommended that getDefaultFontDataArray is used instead.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the default value of the preference

getDefaultPoint

public static Point getDefaultPoint(IPreferenceStore store,
                                    String name)

Returns the default value for the point-valued preference with the given name in the given preference store. Returns the default-default value (POINT_DEFAULT_DEFAULT) is no default preference with the given name, or if the default value cannot be treated as a point.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the default value of the preference

getDefaultRectangle

public static Rectangle getDefaultRectangle(IPreferenceStore store,
                                            String name)

Returns the default value for the rectangle-valued preference with the given name in the given preference store. Returns the default-default value (RECTANGLE_DEFAULT_DEFAULT) is no default preference with the given name, or if the default value cannot be treated as a rectangle.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the default value of the preference

getFontDataArray

public static FontData[] getFontDataArray(IPreferenceStore store,
                                          String name)

Returns the current value of the font-valued preference with the given name in the given preference store. Returns the default-default value (FONTDATA_ARRAY_DEFAULT_DEFAULT) if there is no preference with the given name, or if the current value cannot be treated as font data.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the font-valued preference

getFontData

public static FontData getFontData(IPreferenceStore store,
                                   String name)

Returns the current value of the first entry of the font-valued preference with the given name in the given preference store. Returns the default-default value (FONTDATA_ARRAY_DEFAULT_DEFAULT) if there is no preference with the given name, or if the current value cannot be treated as font data. This API is provided for backwards compatibility. It is recommended that getFontDataArray is used instead.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the font-valued preference

getPoint

public static Point getPoint(IPreferenceStore store,
                             String name)

Returns the current value of the point-valued preference with the given name in the given preference store. Returns the default-default value (POINT_DEFAULT_DEFAULT) if there is no preference with the given name, or if the current value cannot be treated as a point.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the point-valued preference

getRectangle

public static Rectangle getRectangle(IPreferenceStore store,
                                     String name)

Returns the current value of the rectangle-valued preference with the given name in the given preference store. Returns the default-default value (RECTANGLE_DEFAULT_DEFAULT) if there is no preference with the given name, or if the current value cannot be treated as a rectangle.

Parameters:

store - the preference store

name - the name of the preference

Returns:

the rectangle-valued preference

setDefault

public static void setDefault(IPreferenceStore store,
                              String name,
                              FontData value)

Sets the default value of the preference with the given name in the given preference store. As FontDatas are stored as arrays this method is only provided for backwards compatibility. Use setDefault(IPreferenceStore, String, FontData[]) instead.

Parameters:

store - the preference store

name - the name of the preference

value - the new default value of the preference

setDefault

public static void setDefault(IPreferenceStore store,
                              String name,
                              FontData[] value)

Sets the default value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new default value of the preference

setDefault

public static void setDefault(IPreferenceStore store,
                              String name,
                              Point value)

Sets the default value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new defaul value of the preference

setDefault

public static void setDefault(IPreferenceStore store,
                              String name,
                              Rectangle value)

Sets the default value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new defaul value of the preference

setDefault

public static void setDefault(IPreferenceStore store,
                              String name,
                              RGB value)

Sets the default value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new defaul value of the preference

setValue

public static void setValue(IPreferenceStore store,
                            String name,
                            FontData value)

Sets the current value of the preference with the given name in the given preference store. Included for backwards compatibility - use setValue(IPreferenceStore,String,FontData[]) instead.

Parameters:

store - the preference store

name - the name of the preference

value - the new current value of the preference

setValue

public static void setValue(IPreferenceStore store,
                            String name,
                            FontData[] value)

Sets the current value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new current value of the preference

setValue

public static void setValue(IPreferenceStore store,
                            String name,
                            Point value)

Sets the current value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new current value of the preference

setValue

public static void setValue(IPreferenceStore store,
                            String name,
                            Rectangle value)

Sets the current value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new current value of the preference

setValue

public static void setValue(IPreferenceStore store,
                            String name,
                            RGB value)

Sets the current value of the preference with the given name in the given preference store.

Parameters:

store - the preference store

name - the name of the preference

value - the new current value of the preference