- java.lang.Object
-
- java.awt.GraphicsConfigTemplate
-
- All Implemented Interfaces:
Serializable
public abstract class GraphicsConfigTemplate extends Object implements Serializable
TheGraphicsConfigTemplateclass is used to obtain a validGraphicsConfiguration. A user instantiates one of these objects and then sets all non-default attributes as desired. TheGraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate)method found in theGraphicsDeviceclass is then called with thisGraphicsConfigTemplate. A validGraphicsConfigurationis returned that meets or exceeds what was requested in theGraphicsConfigTemplate.- Since:
- 1.2
- See Also:
GraphicsDevice,GraphicsConfiguration, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static intPREFERREDValue used for "Enum" (Integer) type.static intREQUIREDValue used for "Enum" (Integer) type.static intUNNECESSARYValue used for "Enum" (Integer) type.
-
Constructor Summary
Constructors Constructor Description GraphicsConfigTemplate()This class is an abstract class so only subclasses can be instantiated.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description abstract GraphicsConfigurationgetBestConfiguration(GraphicsConfiguration[] gc)Returns the "best" configuration possible that passes the criteria defined in theGraphicsConfigTemplate.abstract booleanisGraphicsConfigSupported(GraphicsConfiguration gc)Returns abooleanindicating whether or not the specifiedGraphicsConfigurationcan be used to create a drawing surface that supports the indicated features.
-
-
-
Field Detail
-
REQUIRED
public static final int REQUIRED
Value used for "Enum" (Integer) type. States that this feature is required for theGraphicsConfigurationobject. If this feature is not available, do not select theGraphicsConfigurationobject.- See Also:
- Constant Field Values
-
PREFERRED
public static final int PREFERRED
Value used for "Enum" (Integer) type. States that this feature is desired for theGraphicsConfigurationobject. 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 theGraphicsConfigurationobject. A selection without this feature is preferred over a selection that includes this feature since it is not used.- See Also:
- Constant Field Values
-
-
Method Detail
-
getBestConfiguration
public abstract GraphicsConfiguration getBestConfiguration(GraphicsConfiguration[] gc)
Returns the "best" configuration possible that passes the criteria defined in theGraphicsConfigTemplate.- Parameters:
gc- the array ofGraphicsConfigurationobjects to choose from.- Returns:
- a
GraphicsConfigurationobject that is the best configuration possible. - See Also:
GraphicsConfiguration
-
isGraphicsConfigSupported
public abstract boolean isGraphicsConfigSupported(GraphicsConfiguration gc)
Returns abooleanindicating whether or not the specifiedGraphicsConfigurationcan be used to create a drawing surface that supports the indicated features.- Parameters:
gc- theGraphicsConfigurationobject to test- Returns:
trueif thisGraphicsConfigurationobject can be used to create surfaces that support the indicated features;falseif theGraphicsConfigurationcan not be used to create a drawing surface usable by this Java(tm) API.
-
-