|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectjava.awt.GraphicsEnvironment
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 and are the destination of
Graphics2D drawing methods. Each GraphicsDevice
has a number of GraphicsConfiguration objects associated with
it. These objects specify the different configurations in which the
GraphicsDevice can be used.
GraphicsDevice,
GraphicsConfiguration| Constructor Summary | |
protected |
GraphicsEnvironment()
This is an abstract class and cannot be instantiated directly. |
| Method Summary | |
abstract Graphics2D |
createGraphics(BufferedImage img)
Returns a Graphics2D object for rendering into the
specified BufferedImage. |
abstract Font[] |
getAllFonts()
Returns an array containing a one-point size instance of all fonts available in this GraphicsEnvironment. |
abstract String[] |
getAvailableFontFamilyNames()
Returns an array containing the names of all font families available in this GraphicsEnvironment. |
abstract String[] |
getAvailableFontFamilyNames(Locale l)
Returns an array containing the localized names of all font families available in this GraphicsEnvironment. |
Point |
getCenterPoint()
Returns the Point where Windows should be centered. |
abstract GraphicsDevice |
getDefaultScreenDevice()
Returns the default screen GraphicsDevice. |
static GraphicsEnvironment |
getLocalGraphicsEnvironment()
Returns the local GraphicsEnvironment. |
Rectangle |
getMaximumWindowBounds()
Returns the maximum bounds for centered Windows. |
abstract GraphicsDevice[] |
getScreenDevices()
Returns an array of all of the screen GraphicsDevice
objects. |
static boolean |
isHeadless()
Tests whether or not a display, keyboard, and mouse can be supported in this environment. |
boolean |
isHeadlessInstance()
Returns whether or not a display, keyboard, and mouse can be supported in this graphics environment. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
protected GraphicsEnvironment()
| Method Detail |
public static GraphicsEnvironment getLocalGraphicsEnvironment()
GraphicsEnvironment.
GraphicsEnvironmentpublic static boolean isHeadless()
true if this environment cannot support
a display, keyboard, and mouse; false
otherwiseHeadlessExceptionpublic boolean isHeadlessInstance()
HeadlessException will be thrown from areas of the
graphics environment that are dependent on a display, keyboard, or
mouse.
true if a display, keyboard, and mouse
can be supported in this environment; false
otherwiseHeadlessException,
isHeadless()
public abstract GraphicsDevice[] getScreenDevices()
throws HeadlessException
GraphicsDevice
objects.
GraphicsDevice
objects that represent screen devices
HeadlessException - if isHeadless() returns trueisHeadless()
public abstract GraphicsDevice getDefaultScreenDevice()
throws HeadlessException
GraphicsDevice.
GraphicsDevice that represents the
default screen device
HeadlessException - if isHeadless() returns trueisHeadless()public abstract Graphics2D createGraphics(BufferedImage img)
Graphics2D object for rendering into the
specified BufferedImage.
img - the specified BufferedImage
Graphics2D to be used for rendering into
the specified BufferedImagepublic abstract Font[] getAllFonts()
GraphicsEnvironment. Typical usage
would be to allow a user to select a particular font. Then, the
application can size the font and set various font attributes by
calling the deriveFont method on the choosen instance.
This method provides for the application the most precise control
over which Font instance is used to render text.
If a font in this GraphicsEnvironment has multiple
programmable variations, only one
instance of that Font is returned in the array, and
other variations must be derived by the application.
If a font in this environment has multiple programmable variations,
such as Multiple-Master fonts, only one instance of that font is
returned in the Font array. The other variations
must be derived by the application.
Font objectsgetAvailableFontFamilyNames(),
Font,
Font.deriveFont(int, float),
Font.getFontName()public abstract String[] getAvailableFontFamilyNames()
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.
String containing names of font
familiesgetAllFonts(),
Font,
Font.getFamily()public abstract String[] getAvailableFontFamilyNames(Locale l)
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.
l - a Locale object that represents a
particular geographical, political, or cultural region
String objects containing names of
font families specific to the specified LocalegetAllFonts(),
Font,
Font.getFamily()
public Point getCenterPoint()
throws HeadlessException
HeadlessException - if isHeadless() returns truegetMaximumWindowBounds()
public Rectangle getMaximumWindowBounds()
throws HeadlessException
To get the usable bounds of a single display, use
GraphicsConfiguration.getBounds() and
Toolkit.getScreenInsets().
HeadlessException - if isHeadless() returns truegetCenterPoint(),
GraphicsConfiguration.getBounds(),
Toolkit.getScreenInsets(java.awt.GraphicsConfiguration)
|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.