alma.acs.gui.util

Class WindowUtil

java.lang.Object

alma.acs.gui.util.WindowUtil

public class WindowUtil
extends java.lang.Object

Helper methods for dealing with Java Windows.

Since:

August 2011

Author:

M.Schilling, ESO

Constructor Summary

Constructors

Constructor and Description
WindowUtil()

Method Summary

Modifier and Type	Method and Description
static boolean	applyGeometry(java.awt.Frame frame, java.lang.String geometry) Assigns position and size to a desktop frame from a textual geometry definition.
static java.awt.Rectangle	parseGeometry(java.lang.String geometry) Parses a geometry string made up of positional parameters "width height xpos ypos" or "xpos ypos" (ie.

Methods inherited from class java.lang.Object

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

Constructor Detail

WindowUtil

public WindowUtil()

Method Detail

applyGeometry

public static boolean applyGeometry(java.awt.Frame frame,
                                    java.lang.String geometry)

Assigns position and size to a desktop frame from a textual geometry definition. For allowed formats of geometry definition, see parseGeometry(String). If geometry is null or cannot be understood, this call will do nothing and return false.

Parameters:

frame - - a desktop frame to position and size

geometry - - a geometry definition string

Returns:

whether the geometry definition was valid and thus applied

parseGeometry

public static java.awt.Rectangle parseGeometry(java.lang.String geometry)
                                        throws java.lang.IllegalArgumentException

Parses a geometry string made up of positional parameters "width height xpos ypos" or "xpos ypos" (ie. X server format), or named parameters "x=...,y=...,w=...,h=...".

Examples:

• 400x500+200+300
• +200+300
• x=200, y=300, w=400, h=500
• x=200y=300w=400h=500
• w=400;h=500;x=200;y=300;

Note that negative x/y coordinates (ie. positioning leftwards from the screen's right border) are not supported.

This method throws IllegalArgumentException if the geometry string is invalid. Using this method and catching that exception provides a simple way of testing a geometry string before use, e.g. when you are parsing command-line arguments.

The returned rectangle will contain 0 for any coordinate that was not defined in the geometry string. This can happen for strings specified in "X server short notation" (where only x and y are defined), and for strings specified in "named parameters" notation (if parameters were omitted).

Parameters:

geometry - - the geometry as text

Returns:

the geometry as a rectangle

Throws:

java.lang.IllegalArgumentException - if the argument is null or cannot be parsed