|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.eclipse.jface.resource.FontRegistry
A font registry maintains a mapping between symbolic font names and SWT fonts.
A font registry owns all of the font objects registered with it, and automatically disposes of them when the SWT Display that creates the fonts is disposed. Because of this, clients do not need to (indeed, must not attempt to) dispose of font objects themselves.
A special constructor is provided for populating a font registry from a property files using the standard Java resource bundle mechanism.
Methods are provided for registering listeners that will be kept apprised of changes to list of registed fonts.
Clients may instantiate this class (it was not designed to be subclassed).
Constructor Summary | |
FontRegistry()
Creates an empty font registry. |
|
FontRegistry(Display display)
Creates an empty font registry. |
|
FontRegistry(String location)
Creates a font registry and initializes its content from a property file. |
Method Summary | |
void |
addListener(IPropertyChangeListener listener)
Adds a property change listener to this registry. |
FontData |
bestData(FontData[] fonts,
Display display)
Find the first valid fontData in the provided list. |
Font |
get(String symbolicName)
Returns the font associated with the given symbolic font name. |
FontData[] |
getFontData(String symbolicName)
Returns the font data associated with the given symbolic font name. |
void |
put(String symbolicName,
FontData[] fontData)
Adds (or replaces) a font to this font registry under the given symbolic name. |
void |
removeListener(IPropertyChangeListener listener)
Removes the given listener from this registry. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public FontRegistry()
There must be an SWT Display created in the current thread before calling this method.
public FontRegistry(String location) throws MissingResourceException
There must be an SWT Display created in the current thread before calling this method.
The OS name (retrieved using System.getProperty("os.name")
)
is converted to lowercase, purged of whitespace, and appended
as suffix (separated by an underscore '_'
) to the given
location string to yield the base name of a resource bundle
acceptable to ResourceBundle.getBundle
.
The standard Java resource bundle mechanism is then used to locate
and open the appropriate properties file, taking into account
locale specific variations.
For example, on the Windows 2000 operating system the location string
"com.example.myapp.Fonts"
yields the base name
"com.example.myapp.Fonts_windows2000"
. For the US English locale,
this further elaborates to the resource bundle name
"com.example.myapp.Fonts_windows2000_en_us"
.
If no appropriate OS-specific resource bundle is found, the process is repeated using the location as the base bundle name.
The property file contains entries that look like this:
textfont.0=MS Sans Serif-regular-10 textfont.1=Times New Roman-regular-10 titlefont.0=MS Sans Serif-regular-12 titlefont.1=Times New Roman-regular-12Each entry maps a symbolic font names (the font registry keys) with a "
.n
suffix to standard font names
on the right. The suffix indicated order of preference:
".0
" indicates the first choice,
".1
" indicates the second choice, and so on.
The following example shows how to use the font registry:
FontRegistry registry = new FontRegistry("com.example.myapp.fonts"); Font font = registry.get("textfont"); control.setFont(font); ...
location
- the name of the resource bundle
MissingResourceException
- if the resource bundle cannot be foundpublic FontRegistry(Display display)
display
- the DisplayMethod Detail |
public void addListener(IPropertyChangeListener listener)
listener
- a property change listenerpublic FontData bestData(FontData[] fonts, Display display)
public FontData[] getFontData(String symbolicName)
symbolicName
- symbolic font name
public Font get(String symbolicName)
symbolicName
- symbolic font name
public void put(String symbolicName, FontData[] fontData)
A property change event is reported whenever the mapping from a symbolic name to a font changes. The source of the event is this registry; the property name is the symbolic font name.
symbolicName
- the symbolic font namefontData
- an Array of FontDatapublic void removeListener(IPropertyChangeListener listener)
listener
- a property change listener
|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |