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

In a virtual device multi-screen environment in which the desktop area could span multiple physical screen devices, the bounds of the GraphicsConfiguration objects are relative to the virtual coordinate system. When setting the location of a component, use GraphicsConfiguration.getBounds() getBounds to get the bounds of the desired GraphicsConfiguration and offset the location with the coordinates of the GraphicsConfiguration, as the following code sample illustrates:

 Frame f = new Frame(gc);  // where gc is a GraphicsConfiguration
 Rectangle bounds = gc.getBounds();
 f.setLocation(10 + bounds.x, 10 + bounds.y); 

To determine if your environment is a virtual device environment, call getBounds on all of the GraphicsConfiguration objects in your system. If any of the origins of the returned bounds is not (0, 0), your environment is a virtual device environment.

You can also use getBounds to determine the bounds of the virtual device. To do this, first call getBounds on all of the GraphicsConfiguration objects in your system. Then calculate the union of all of the bounds returned from the calls to getBounds. The union is the bounds of the virtual device. The following code sample calculates the bounds of the virtual device.

 Rectangle virtualBounds = new Rectangle();
 GraphicsEnvironment ge = GraphicsEnvironment.
 getLocalGraphicsEnvironment();
 GraphicsDevice[] gs =
 ge.getScreenDevices();
 for (int j = 0; j < gs.length; j++) { 
 GraphicsDevice gd = gs[j];
 GraphicsConfiguration[] gc =
 gd.getConfigurations();
 for (int i=0; i < gc.length; i++) {
 virtualBounds =
 virtualBounds.union(gc[i].getBounds());
 }
 } 

For a particular Graphics2D , g, one can reset the transformation to create such a mapping by using the following pseudocode:

 GraphicsConfiguration gc = g.getDeviceConfiguration();
 g.setTransform(gc.getDefaultTransform());
 g.transform(gc.getNormalizingTransform());