ice.pilots.html4
Interface FontProvider

All Known Implementing Classes:

JavaFontProvider

public interface FontProvider

This interface outlines the methods required by classes wishing to act as Font sources for the ICEBrowser. FontProviders allow for third party sources of java.awt.Font objects to be incorporated into the mainstream Font caching structure of ICEBrowser.

A FontProvider provides simple facilities for:

• Testing if a given FontFamily is supported
• Retrieving an instance of that Font
• Retrieving a list of all FontFamilies that the FontProvider supports
• Retrieving a FontMetrics object for that Font family

  Field Summary

  static String

  JAVA_VM Symbolic constant for the JavaVM Font provider

  Method Summary

  Font	getFont(String fontFamily, int fontStyle, int fontSize) Retrieve a Font from the FontProvider.
  String[]	getFontFamilies() Retrieve an array of Font family names implemented by the FontProvider.
  FontMetrics	getFontMetrics(Font font) Retrieve the FontMetrics object for the given Font.
  boolean	isFamilySupported(String fontFamily) A less expensive way of determining if a given FontProvider can provide a Font implementation for a given Font family than getting the Font.

  Field Detail

  JAVA_VM

  public static final String JAVA_VM

  Symbolic constant for the JavaVM Font provider

  See Also:

  Constant Field Values

  Method Detail

  getFont

  public Font getFont(String fontFamily,
                      int fontStyle,
                      int fontSize)

  Retrieve a Font from the FontProvider. Specify the Font family, size, and style and allow a FontProvider to attempt to provide an implementation. The FontProvider may return null if it cannot provide a Font with the given parameters

  Parameters:

  fontFamily - the Font family name

  fontStyle - Enumerated style as in the java.awt.Font style argument

  fontSize - size of the Font in points (same as the Java argument)

  Returns:

  the Font object provided by the service, or null if the FontProvider cannot return a Font of the given properties

  getFontFamilies

  public String[] getFontFamilies()

  Retrieve an array of Font family names implemented by the FontProvider. This method will be invoked before attempting any Font searching, allowing the FontProvider to implement run-time Font management.

  Returns:

  An array of Font Family names.

  isFamilySupported

  public boolean isFamilySupported(String fontFamily)

  A less expensive way of determining if a given FontProvider can provide a Font implementation for a given Font family than getting the Font. The implementation of this

  Parameters:

  fontFamily - The name of the Font family

  Returns:

  true if the Font provider can support the given Font

  getFontMetrics

  public FontMetrics getFontMetrics(Font font)

  Retrieve the FontMetrics object for the given Font. On some platforms, the original method of getting the FontMetrics information doesn't work in Headless mode. There are solutions, but they all entail specialized techniques to > Java1.2. This method allows the FontProvider to perform the work, which allows for the creation of specific instances that can take advantage of the environment

  Parameters:

  font - The font to retrieve the FontMetrics object for

  Returns:

  FontMetrics object for the Font