org.jadice.util.swing.geometry

Class ScreenGeometry

java.lang.Object

org.jadice.util.swing.geometry.ScreenGeometry

public class ScreenGeometry
extends Object

An utility class for screen geometry in a mutli screen environment and positioning of swing components.

Constructor Summary

Constructors

Constructor and Description
ScreenGeometry()

Method Summary

Modifier and Type	Method and Description
static void	adjustComponentLocationOnScreen(Component component, List<GraphicsConfiguration> availableGraphicsConfiguration) Adjust the component location, if possible, so that it is completely inside the available graphic configuration.
static void	adjustWindowLocationOnScreen(Window window) Check whether the given window is completely on screen.
static List<GraphicsConfiguration>	getAvailableGraphicsConfigurations() Gets the available GraphicsConfiguration.
static Rectangle	getScreenBounds(GraphicsConfiguration gc) Get the screen bounds for a given GraphicsConfiguration respecting the screen insets.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ScreenGeometry

public ScreenGeometry()

Method Detail

adjustWindowLocationOnScreen

public static void adjustWindowLocationOnScreen(Window window)

Check whether the given window is completely on screen. If not, its position will be adjusted. Please note, this method does not ensure that the given window fits completely onto the screen. If a window is larger than the specified screen size, the window will not be reduced in size.

Please note, Window is the base class of all window types, such as JFrame, JDialog and so on. So this method can be used for all subtypes of windows.

Parameters:

window - the window to check

adjustComponentLocationOnScreen

public static void adjustComponentLocationOnScreen(Component component,
                                                   List<GraphicsConfiguration> availableGraphicsConfiguration)

Adjust the component location, if possible, so that it is completely inside the available graphic configuration. Although the method will make some effort to place the component nicely it may end up partially outside the regions. This could happen either because the component doesn't fit at all, or the regions of the graphic configurations are placed not not sufficiently.

Parameters:

component - the component to adjust

availableGraphicsConfiguration - all currently available screen graphic configurations

getAvailableGraphicsConfigurations

public static List<GraphicsConfiguration> getAvailableGraphicsConfigurations()

Gets the available GraphicsConfiguration. In a headless environment the resulting list will be empty.

Returns:

all available GraphicsConfiguration

getScreenBounds

public static Rectangle getScreenBounds(GraphicsConfiguration gc)

Get the screen bounds for a given GraphicsConfiguration respecting the screen insets.

Parameters:

gc - given GraphicsConfiguration

Returns:

the screen bounds for a given GraphicsConfiguration respecting its screen insets or the toolkit bounds if the parameter is null.