java.awt
Class GraphicsConfigTemplate

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.awt.GraphicsConfigTemplate
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable

public abstract class GraphicsConfigTemplate
extends Object sample code for java.lang.Object definition code for java.lang.Object
implements Serializable sample code for java.io.Serializable definition code for java.io.Serializable

The GraphicsConfigTemplate class is used to obtain a valid GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration . A user instantiates one of these objects and then sets all non-default attributes as desired. The GraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate) sample code for java.awt.GraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate) definition code for java.awt.GraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate) method found in the GraphicsDevice sample code for java.awt.GraphicsDevice definition code for java.awt.GraphicsDevice class is then called with this GraphicsConfigTemplate. A valid GraphicsConfiguration is returned that meets or exceeds what was requested in the GraphicsConfigTemplate.

Since:
1.2
See Also:
GraphicsDevice sample code for java.awt.GraphicsDevice definition code for java.awt.GraphicsDevice , GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration , Serialized Form

Field Summary
static int PREFERRED sample code for java.awt.GraphicsConfigTemplate.PREFERRED definition code for java.awt.GraphicsConfigTemplate.PREFERRED
          Value used for "Enum" (Integer) type.
static int REQUIRED sample code for java.awt.GraphicsConfigTemplate.REQUIRED definition code for java.awt.GraphicsConfigTemplate.REQUIRED
          Value used for "Enum" (Integer) type.
static int UNNECESSARY sample code for java.awt.GraphicsConfigTemplate.UNNECESSARY definition code for java.awt.GraphicsConfigTemplate.UNNECESSARY
          Value used for "Enum" (Integer) type.
 
Constructor Summary
GraphicsConfigTemplate sample code for java.awt.GraphicsConfigTemplate.GraphicsConfigTemplate() definition code for java.awt.GraphicsConfigTemplate.GraphicsConfigTemplate() ()
          This class is an abstract class so only subclasses can be instantiated.
 
Method Summary
abstract  GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration getBestConfiguration sample code for java.awt.GraphicsConfigTemplate.getBestConfiguration(java.awt.GraphicsConfiguration[]) definition code for java.awt.GraphicsConfigTemplate.getBestConfiguration(java.awt.GraphicsConfiguration[]) (GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration [] gc)
          Returns the "best" configuration possible that passes the criteria defined in the GraphicsConfigTemplate.
abstract  boolean isGraphicsConfigSupported sample code for java.awt.GraphicsConfigTemplate.isGraphicsConfigSupported(java.awt.GraphicsConfiguration) definition code for java.awt.GraphicsConfigTemplate.isGraphicsConfigSupported(java.awt.GraphicsConfiguration) (GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration  gc)
          Returns a boolean indicating whether or not the specified GraphicsConfiguration can be used to create a drawing surface that supports the indicated features.
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , hashCode sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , toString sample code for java.lang.Object.toString() definition code for java.lang.Object.toString() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Field Detail

REQUIRED sample code for java.awt.GraphicsConfigTemplate.REQUIRED

public static final int REQUIRED
Value used for "Enum" (Integer) type. States that this feature is required for the GraphicsConfiguration object. If this feature is not available, do not select the GraphicsConfiguration object.

See Also:
Constant Field Values

PREFERRED sample code for java.awt.GraphicsConfigTemplate.PREFERRED

public static final int PREFERRED
Value used for "Enum" (Integer) type. States that this feature is desired for the GraphicsConfiguration object. A selection with this feature is preferred over a selection that does not include this feature, although both selections can be considered valid matches.

See Also:
Constant Field Values

UNNECESSARY sample code for java.awt.GraphicsConfigTemplate.UNNECESSARY

public static final int UNNECESSARY
Value used for "Enum" (Integer) type. States that this feature is not necessary for the selection of the GraphicsConfiguration object. A selection without this feature is preferred over a selection that includes this feature since it is not used.

See Also:
Constant Field Values
Constructor Detail

GraphicsConfigTemplate sample code for java.awt.GraphicsConfigTemplate() definition code for java.awt.GraphicsConfigTemplate()

public GraphicsConfigTemplate()
This class is an abstract class so only subclasses can be instantiated.

Method Detail

getBestConfiguration sample code for java.awt.GraphicsConfigTemplate.getBestConfiguration(java.awt.GraphicsConfiguration[]) definition code for java.awt.GraphicsConfigTemplate.getBestConfiguration(java.awt.GraphicsConfiguration[])

public abstract GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration  getBestConfiguration(GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration [] gc)
Returns the "best" configuration possible that passes the criteria defined in the GraphicsConfigTemplate.

Parameters:
gc - the array of GraphicsConfiguration objects to choose from.
Returns:
a GraphicsConfiguration object that is the best configuration possible.
See Also:
GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration

isGraphicsConfigSupported sample code for java.awt.GraphicsConfigTemplate.isGraphicsConfigSupported(java.awt.GraphicsConfiguration) definition code for java.awt.GraphicsConfigTemplate.isGraphicsConfigSupported(java.awt.GraphicsConfiguration)

public abstract boolean isGraphicsConfigSupported(GraphicsConfiguration sample code for java.awt.GraphicsConfiguration definition code for java.awt.GraphicsConfiguration  gc)
Returns a boolean indicating whether or not the specified GraphicsConfiguration can be used to create a drawing surface that supports the indicated features.

Parameters:
gc - the GraphicsConfiguration object to test
Returns:
true if this GraphicsConfiguration object can be used to create surfaces that support the indicated features; false if the GraphicsConfiguration can not be used to create a drawing surface usable by this Java(tm) API.