PDAP Public Review Draft

java.awt
Class GraphicsEnvironment

java.lang.Object
  |
  +--java.awt.GraphicsEnvironment

public abstract class GraphicsEnvironment
extends java.lang.Object

The GraphicsEnvironment class describes the collection of GraphicsDevice objects and Font objects available to a Java(tm) application on a particular platform. The resources in this GraphicsEnvironment might be local or on a remote machine. GraphicsDevice objects can be screens, printers or image buffers. Each GraphicsDevice has a number of GraphicsConfiguration objects associated with it. These objects specify the different configurations in which the GraphicsDevice can be used.

See Also:
GraphicsDevice, GraphicsConfiguration

Constructor Summary
protected GraphicsEnvironment()
          This is an abstract class and cannot be instantiated directly.
 
Method Summary
abstract  java.lang.String[] getAvailableFontFamilyNames()
          Returns an array containing the names of all font families available in this GraphicsEnvironment.
abstract  java.lang.String[] getAvailableFontFamilyNames(Locale l)
          Returns an array containing the localized names of all font families available in this GraphicsEnvironment.
abstract  GraphicsDevice getDefaultScreenDevice()
          Returns the default screen GraphicsDevice.
static GraphicsEnvironment getLocalGraphicsEnvironment()
          Returns the local GraphicsEnvironment.
abstract  GraphicsDevice[] getScreenDevices()
          Returns an array of all of the screen GraphicsDevice objects.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GraphicsEnvironment

protected GraphicsEnvironment()
This is an abstract class and cannot be instantiated directly. Instances must be obtained from a suitable factory or query method.
Method Detail

getLocalGraphicsEnvironment

public static GraphicsEnvironment getLocalGraphicsEnvironment()
Returns the local GraphicsEnvironment.
Returns:
this GraphicsEnvironment.

getScreenDevices

public abstract GraphicsDevice[] getScreenDevices()
Returns an array of all of the screen GraphicsDevice objects.
Returns:
an array containing all the GraphicsDevice objects that represent screen devices.

getDefaultScreenDevice

public abstract GraphicsDevice getDefaultScreenDevice()
Returns the default screen GraphicsDevice.
Returns:
the GraphicsDevice that represents the default screen device.

getAvailableFontFamilyNames

public abstract java.lang.String[] getAvailableFontFamilyNames()
Returns an array containing the names of all font families available in this GraphicsEnvironment. Typical usage would be to allow a user to select a particular family name and allow the application to choose related variants of the same family when the user specifies style attributes such as Bold or Italic.

This method provides for the application some control over which Font instance is used to render text, but allows the Font object more flexibility in choosing its own best match among multiple fonts in the same font family.

Returns:
an array of String containing names of font families.
Since:
1.2
See Also:
Font, Font.getFamily()

getAvailableFontFamilyNames

public abstract java.lang.String[] getAvailableFontFamilyNames(Locale l)
Returns an array containing the localized names of all font families available in this GraphicsEnvironment. Typical usage would be to allow a user to select a particular family name and allow the application to choose related variants of the same family when the user specifies style attributes such as Bold or Italic.

This method provides for the application some control over which Font instance used to render text, but allows the Font object more flexibility in choosing its own best match among multiple fonts in the same font family. If l is null, this method returns an array containing all font family names available in this GraphicsEnvironment.

Parameters:
l - a Locale object that represents a particular geographical, political, or cultural region
Returns:
an array of String objects containing names of font families specific to the specified Locale.
Since:
1.2
See Also:
Font, Font.getFamily()

PDAP 1.0 Spec, Rev. 0.16