org.assertj.swing.awt

Class AWT

java.lang.Object

org.assertj.swing.awt.AWT

public class AWT
extends Object

Utility methods related to AWT.

Author:

Alex Ruiz

Method Summary

Modifier and Type	Method and Description
static Point	centerOf(Component c) Returns a point at the center of the given AWT or Swing Component.
static Point	centerOf(Rectangle r) Returns a point at the center of the given Rectangle.
static Point	centerOfVisibleRect(JComponent c) Returns a point at the center of the visible rectangle of the given JComponent.
static Insets	insetsFrom(Container c) Returns the insets of the given AWT or Swing Container, or an empty one if no insets can be found.
static Component	invokerOf(Component c) Returns the invoker, if any, of the given AWT or Swing Component; or null, if the Component is not on a pop-up of any sort.
static boolean	isAppletViewer(Component c) Returns true if the given component is an Applet viewer.
static boolean	isHeavyWeightPopup(Component c) Returns whether the given AWT or Swing Component is a heavy-weight pop-up, that is, a container for a JPopupMenu that is implemented with a heavy-weight component (usually an AWT or Swing Window).
static boolean	isPointInScreenBoundaries(JComponent c, Point p) Indicates whether the given point, relative to the given JComponent, is inside the screen boundaries.
static boolean	isPointInScreenBoundaries(Point p) Indicates whether the given point is inside the screen boundaries.
static boolean	isSharedInvisibleFrame(Component c) Returns whether the given component is the default Swing hidden frame.
static Point	locationOnScreenOf(Component c) Wrapper for Component.getLocationOnScreen.
static int	popupMask()
static boolean	popupOnPress() Returns whether the platform registers a pop-up on mouse press.
static Point	translate(Component c, int x, int y) Translates the given coordinates to the location on screen of the given AWT or Swing Component.
static Point	visibleCenterOf(Component c) Returns a point at the center of the visible area of the given AWT or Swing Component.

Methods inherited from class java.lang.Object

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

Method Detail

isPointInScreenBoundaries

@RunsInCurrentThread
public static boolean isPointInScreenBoundaries(@Nonnull
                                                                     JComponent c,
                                                                     @Nonnull
                                                                     Point p)

Indicates whether the given point, relative to the given JComponent, is inside the screen boundaries.

Parameters:

c - the given JComponent.

p - the point to verify.

Returns:

true if the point is inside the screen boundaries; false otherwise.

isPointInScreenBoundaries

public static boolean isPointInScreenBoundaries(@Nonnull
                                                Point p)

Indicates whether the given point is inside the screen boundaries.

Parameters:

p - the point to verify.

Returns:

true if the point is inside the screen boundaries; false otherwise.

translate

@RunsInCurrentThread
 @Nullable
public static Point translate(@Nonnull
                                                              Component c,
                                                              int x,
                                                              int y)

Translates the given coordinates to the location on screen of the given AWT or Swing Component.

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

c - the given Component.

x - X coordinate.

y - Y coordinate.

Returns:

the translated coordinates.

visibleCenterOf

@RunsInEDT
 @Nonnull
public static Point visibleCenterOf(@Nonnull
                                                         Component c)

Returns a point at the center of the visible area of the given AWT or Swing Component.

Parameters:

c - the given Component.

Returns:

a point at the center of the visible area of the given Component.

centerOf

@RunsInCurrentThread
 @Nonnull
public static Point centerOf(@Nonnull
                                                            Component c)

Returns a point at the center of the given AWT or Swing Component.

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

c - the given Component.

Returns:

a point at the center of the given Component.

centerOfVisibleRect

@RunsInCurrentThread
 @Nonnull
public static Point centerOfVisibleRect(@Nonnull
                                                                       JComponent c)

Returns a point at the center of the visible rectangle of the given JComponent.

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

c - the given JComponent.

Returns:

a point at the center of the visible rectangle of the given JComponent.

centerOf

@RunsInCurrentThread
 @Nonnull
public static Point centerOf(@Nonnull
                                                            Rectangle r)

Returns a point at the center of the given Rectangle.

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

r - the given Rectangle.

Returns:

a point at the center of the given Rectangle.

insetsFrom

@RunsInCurrentThread
 @Nonnull
public static Insets insetsFrom(@Nonnull
                                                               Container c)

Returns the insets of the given AWT or Swing Container, or an empty one if no insets can be found.

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

c - the given Container.

Returns:

the insets of the given Container, or an empty one if no insets can be found.

isAppletViewer

public static boolean isAppletViewer(@Nullable
                                     Component c)

Returns true if the given component is an Applet viewer.

Parameters:

c - the component to check.

Returns:

true if the given component is an Applet viewer, false otherwise.

isSharedInvisibleFrame

public static boolean isSharedInvisibleFrame(@Nullable
                                             Component c)

Returns whether the given component is the default Swing hidden frame.

Parameters:

c - the component to check.

Returns:

true if the given component is the default hidden frame, false otherwise.

isHeavyWeightPopup

@RunsInCurrentThread
public static boolean isHeavyWeightPopup(@Nonnull
                                                              Component c)

Returns whether the given AWT or Swing Component is a heavy-weight pop-up, that is, a container for a JPopupMenu that is implemented with a heavy-weight component (usually an AWT or Swing Window).

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

c - the given Component.

Returns:

true if the given Component is a heavy-weight pop-up; false otherwise.

invokerOf

@RunsInCurrentThread
 @Nullable
public static Component invokerOf(@Nonnull
                                                                  Component c)

Returns the invoker, if any, of the given AWT or Swing Component; or null, if the Component is not on a pop-up of any sort.

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

c - the given Component.

Returns:

the invoker, if any, of the given Component; or null, if the Component is not on a pop-up of any sort.

locationOnScreenOf

@RunsInCurrentThread
 @Nonnull
public static Point locationOnScreenOf(@Nonnull
                                                                      Component c)

Wrapper for Component.getLocationOnScreen.

Note: This method is accessed in the current executing thread. Such thread may or may not be the event dispatch thread (EDT). Client code must call this method from the EDT.

Parameters:

c - the given AWT or Swing Component.

Returns:

the a point specifying the Component's top-left corner in the screen's coordinate space.

popupOnPress

public static boolean popupOnPress()

Returns whether the platform registers a pop-up on mouse press.

Returns:

true if the platform registers a pop-up on mouse press, false otherwise.

popupMask

public static int popupMask()

Returns:

the InputEvent mask for the pop-up trigger button.