GraphicsConfigTemplate (Java Platform SE 7 b138)

java.lang.Object
- java.awt.GraphicsConfigTemplate

All Implemented Interfaces:

Serializable
```
public abstract class GraphicsConfigTemplate
extends Object
implements Serializable
```
The GraphicsConfigTemplate class is used to obtain a valid GraphicsConfiguration. A user instantiates one of these objects and then sets all non-default attributes as desired. The GraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate) method found in the 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, GraphicsConfiguration, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`PREFERRED` Value used for "Enum" (Integer) type.
`static int`	`REQUIRED` Value used for "Enum" (Integer) type.
`static int`	`UNNECESSARY` Value used for "Enum" (Integer) type.

Constructor Summary

Constructors
Constructor and Description

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

Constructors
Constructor and Description
`GraphicsConfigTemplate()` This class is an abstract class so only subclasses can be instantiated.

Method Summary

Methods
Modifier and Type	Method and Description
`abstract GraphicsConfiguration`	`getBestConfiguration(GraphicsConfiguration[] gc)` Returns the "best" configuration possible that passes the criteria defined in the `GraphicsConfigTemplate`.
`abstract boolean`	`isGraphicsConfigSupported(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
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - 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
```
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
```
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
```
public GraphicsConfigTemplate()
```
    This class is an abstract class so only subclasses can be instantiated.
- Method Detail
  - getBestConfiguration
```
public abstract GraphicsConfiguration getBestConfiguration(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
  - isGraphicsConfigSupported
```
public abstract boolean isGraphicsConfigSupported(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.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138

Class GraphicsConfigTemplate

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

REQUIRED

PREFERRED

UNNECESSARY

Constructor Detail

GraphicsConfigTemplate

Method Detail

getBestConfiguration

isGraphicsConfigSupported