Java Doc for GraphicsEnvironment.java in  » 6.0-JDK-Core » AWT » java » awt » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Home
Java Source Code / Java Documentation
1.6.0 JDK Core
2.6.0 JDK Modules
3.6.0 JDK Modules com.sun
4.6.0 JDK Modules com.sun.java
5.6.0 JDK Modules sun
6.6.0 JDK Platform
7.Ajax
8.Apache Harmony Java SE
9.Aspect oriented
10.Authentication Authorization
11.Blogger System
12.Build
13.Byte Code
14.Cache
15.Chart
16.Chat
17.Code Analyzer
18.Collaboration
19.Content Management System
20.Database Client
21.Database DBMS
22.Database JDBC Connection Pool
23.Database ORM
24.Development
25.EJB Server
26.ERP CRM Financial
27.ESB
28.Forum
29.Game
30.GIS
31.Graphic 3D
32.Graphic Library
33.Groupware
34.HTML Parser
35.IDE
36.IDE Eclipse
37.IDE Netbeans
38.Installer
39.Internationalization Localization
40.Inversion of Control
41.Issue Tracking
42.J2EE
43.J2ME
44.JBoss
45.JMS
46.JMX
47.Library
48.Mail Clients
49.Music
50.Net
51.Parser
52.PDF
53.Portal
54.Profiler
55.Project Management
56.Report
57.RSS RDF
58.Rule Engine
59.Science
60.Scripting
61.Search Engine
62.Security
63.Sevlet Container
64.Source Control
65.Swing Library
66.Template Engine
67.Test Coverage
68.Testing
69.UML
70.Web Crawler
71.Web Framework
72.Web Mail
73.Web Server
74.Web Services
75.Web Services apache cxf 2.2.6
76.Web Services AXIS2
77.Wiki Engine
78.Workflow Engines
79.XML
80.XML UI
Java Source Code / Java Documentation » 6.0 JDK Core » AWT » java.awt 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   java.awt.GraphicsEnvironment

GraphicsEnvironment
abstract public class GraphicsEnvironment (Code)
The GraphicsEnvironment class describes the collection of GraphicsDevice objects and java.awt.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.
See Also:   GraphicsDevice
See Also:   GraphicsConfiguration
version:
   1.74, 06/04/07



Constructor Summary
protected  GraphicsEnvironment()
     This is an abstract class and cannot be instantiated directly.

Method Summary
static  voidcheckHeadless()
    
abstract public  Graphics2DcreateGraphics(BufferedImage img)
     Returns a Graphics2D object for rendering into the specified BufferedImage .
abstract public  Font[]getAllFonts()
     Returns an array containing a one-point size instance of all fonts available in this GraphicsEnvironment.
abstract public  String[]getAvailableFontFamilyNames()
     Returns an array containing the names of all font families in this GraphicsEnvironment localized for the default locale, as returned by Locale.getDefault().

Typical usage would be for presentation to a user for selection of a particular family name.

abstract public  String[]getAvailableFontFamilyNames(Locale l)
     Returns an array containing the names of all font families in this GraphicsEnvironment localized for the specified locale.

Typical usage would be for presentation to a user for selection of a particular family name.

public  PointgetCenterPoint()
     Returns the Point where Windows should be centered.
abstract public  GraphicsDevicegetDefaultScreenDevice()
     Returns the default screen GraphicsDevice.
static  StringgetHeadlessMessage()
    
public static synchronized  GraphicsEnvironmentgetLocalGraphicsEnvironment()
     Returns the local GraphicsEnvironment.
public  RectanglegetMaximumWindowBounds()
     Returns the maximum bounds for centered Windows. These bounds account for objects in the native windowing system such as task bars and menu bars.
abstract public  GraphicsDevice[]getScreenDevices()
     Returns an array of all of the screen GraphicsDevice objects.
public static  booleanisHeadless()
     Tests whether or not a display, keyboard, and mouse can be supported in this environment.
public  booleanisHeadlessInstance()
     Returns whether or not a display, keyboard, and mouse can be supported in this graphics environment.
public  voidpreferLocaleFonts()
     Indicates a preference for locale-specific fonts in the mapping of logical fonts to physical fonts.
public  voidpreferProportionalFonts()
     Indicates a preference for proportional over non-proportional (e.g. dual-spaced CJK fonts) fonts in the mapping of logical fonts to physical fonts.
public  booleanregisterFont(Font font)
     Registers a created Fontin this GraphicsEnvironment. A created font is one that was returned from calling Font.createFont , or derived from a created font by calling Font.deriveFont . After calling this method for such a font, it is available to be used in constructing new Fonts by name or family name, and is enumerated by GraphicsEnvironment.getAvailableFontFamilyNames and GraphicsEnvironment.getAllFonts within the execution context of this application or applet.


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




Method Detail
checkHeadless
static void checkHeadless() throws HeadlessException(Code)
Check for headless state and throw HeadlessException if headless
since:
   1.4



createGraphics
abstract public Graphics2D createGraphics(BufferedImage img)(Code)
Returns a Graphics2D object for rendering into the specified BufferedImage .
Parameters:
  img - the specified BufferedImage a Graphics2D to be used for rendering intothe specified BufferedImage
throws:
  NullPointerException - if img is null



getAllFonts
abstract public Font[] getAllFonts()(Code)
Returns an array containing a one-point size instance of all fonts available in this 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. an array of Font objects
See Also:   GraphicsEnvironment.getAvailableFontFamilyNames
See Also:   java.awt.Font
See Also:   java.awt.Font.deriveFont
See Also:   java.awt.Font.getFontName
since:
   1.2




getAvailableFontFamilyNames
abstract public String[] getAvailableFontFamilyNames()(Code)
Returns an array containing the names of all font families in this GraphicsEnvironment localized for the default locale, as returned by Locale.getDefault().

Typical usage would be for presentation to a user for selection of a particular family name. An application can then specify this name when creating a font, in conjunction with a style, such as bold or italic, giving the font system flexibility in choosing its own best match among multiple fonts in the same font family. an array of String containing font family nameslocalized for the default locale, or a suitable alternativename if no name exists for this locale.
See Also:   GraphicsEnvironment.getAllFonts
See Also:   java.awt.Font
See Also:   java.awt.Font.getFamily
since:
   1.2




getAvailableFontFamilyNames
abstract public String[] getAvailableFontFamilyNames(Locale l)(Code)
Returns an array containing the names of all font families in this GraphicsEnvironment localized for the specified locale.

Typical usage would be for presentation to a user for selection of a particular family name. An application can then specify this name when creating a font, in conjunction with a style, such as bold or italic, giving the font system flexibility in choosing its own best match among multiple fonts in the same font family.
Parameters:
  l - a Locale object that represents aparticular geographical, political, or cultural region.Specifying null is equivalent tospecifying Locale.getDefault(). an array of String containing font family nameslocalized for the specified Locale, or asuitable alternative name if no name exists for the specified locale.
See Also:   GraphicsEnvironment.getAllFonts
See Also:   java.awt.Font
See Also:   java.awt.Font.getFamily
since:
   1.2




getCenterPoint
public Point getCenterPoint() throws HeadlessException(Code)
Returns the Point where Windows should be centered. It is recommended that centered Windows be checked to ensure they fit within the available display area using getMaximumWindowBounds(). the point where Windows should be centered
exception:
  HeadlessException - if isHeadless() returns true
See Also:   GraphicsEnvironment.getMaximumWindowBounds
since:
   1.4



getDefaultScreenDevice
abstract public GraphicsDevice getDefaultScreenDevice() throws HeadlessException(Code)
Returns the default screen GraphicsDevice. the GraphicsDevice that represents thedefault screen device
exception:
  HeadlessException - if isHeadless() returns true
See Also:   GraphicsEnvironment.isHeadless()



getHeadlessMessage
static String getHeadlessMessage()(Code)
warning message if headless state is assumed by default;null otherwise
since:
   1.5



getLocalGraphicsEnvironment
public static synchronized GraphicsEnvironment getLocalGraphicsEnvironment()(Code)
Returns the local GraphicsEnvironment. the local GraphicsEnvironment



getMaximumWindowBounds
public Rectangle getMaximumWindowBounds() throws HeadlessException(Code)
Returns the maximum bounds for centered Windows. These bounds account for objects in the native windowing system such as task bars and menu bars. The returned bounds will reside on a single display with one exception: on multi-screen systems where Windows should be centered across all displays, this method returns the bounds of the entire display area.

To get the usable bounds of a single display, use GraphicsConfiguration.getBounds() and Toolkit.getScreenInsets(). the maximum bounds for centered Windows
exception:
  HeadlessException - if isHeadless() returns true
See Also:   GraphicsEnvironment.getCenterPoint
See Also:   GraphicsConfiguration.getBounds
See Also:   Toolkit.getScreenInsets
since:
   1.4




getScreenDevices
abstract public GraphicsDevice[] getScreenDevices() throws HeadlessException(Code)
Returns an array of all of the screen GraphicsDevice objects. an array containing all the GraphicsDeviceobjects that represent screen devices
exception:
  HeadlessException - if isHeadless() returns true
See Also:   GraphicsEnvironment.isHeadless()



isHeadless
public static boolean isHeadless()(Code)
Tests whether or not a display, keyboard, and mouse can be supported in this environment. If this method returns true, a HeadlessException is thrown from areas of the Toolkit and GraphicsEnvironment that are dependent on a display, keyboard, or mouse. true if this environment cannot support a display, keyboard, and mouse; false otherwise
See Also:   java.awt.HeadlessException
since:
   1.4



isHeadlessInstance
public boolean isHeadlessInstance()(Code)
Returns whether or not a display, keyboard, and mouse can be supported in this graphics environment. If this returns true, 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; falseotherwise
See Also:   java.awt.HeadlessException
See Also:   GraphicsEnvironment.isHeadless
since:
   1.4



preferLocaleFonts
public void preferLocaleFonts()(Code)
Indicates a preference for locale-specific fonts in the mapping of logical fonts to physical fonts. Calling this method indicates that font rendering should primarily use fonts specific to the primary writing system (the one indicated by the default encoding and the initial default locale). For example, if the primary writing system is Japanese, then characters should be rendered using a Japanese font if possible, and other fonts should only be used for characters for which the Japanese font doesn't have glyphs.

The actual change in font rendering behavior resulting from a call to this method is implementation dependent; it may have no effect at all, or the requested behavior may already match the default behavior. The behavior may differ between font rendering in lightweight and peered components. Since calling this method requests a different font, clients should expect different metrics, and may need to recalculate window sizes and layout. Therefore this method should be called before user interface initialisation.
since:
   1.5




preferProportionalFonts
public void preferProportionalFonts()(Code)
Indicates a preference for proportional over non-proportional (e.g. dual-spaced CJK fonts) fonts in the mapping of logical fonts to physical fonts. If the default mapping contains fonts for which proportional and non-proportional variants exist, then calling this method indicates the mapping should use a proportional variant.

The actual change in font rendering behavior resulting from a call to this method is implementation dependent; it may have no effect at all. The behavior may differ between font rendering in lightweight and peered components. Since calling this method requests a different font, clients should expect different metrics, and may need to recalculate window sizes and layout. Therefore this method should be called before user interface initialisation.
since:
   1.5




registerFont
public boolean registerFont(Font font)(Code)
Registers a created Fontin this GraphicsEnvironment. A created font is one that was returned from calling Font.createFont , or derived from a created font by calling Font.deriveFont . After calling this method for such a font, it is available to be used in constructing new Fonts by name or family name, and is enumerated by GraphicsEnvironment.getAvailableFontFamilyNames and GraphicsEnvironment.getAllFonts within the execution context of this application or applet. This means applets cannot register fonts in a way that they are visible to other applets.

Reasons that this method might not register the font and therefore return false are:

  • The font is not a created Font.
  • The font conflicts with a non-created Font already in this GraphicsEnvironment. For example if the name is that of a system font, or a logical font as described in the documentation of the Font class. It is implementation dependent whether a font may also conflict if it has the same family name as a system font.

    Notice that an application can supersede the registration of an earlier created font with a new one.

true if the font is successfullyregistered in this GraphicsEnvironment.
throws:
  NullPointerException - if font is null
since:
   1.6



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.