oracle.ide.util
Class GraphicsUtils

java.lang.Object
  oracle.javatools.util.GraphicsUtils
      oracle.ide.util.GraphicsUtils

public final class GraphicsUtils
extends GraphicsUtils

GraphicsUtils defines common user-interface related utility functions.

Field Summary

protected static java.awt.Component	component
protected static java.awt.MediaTracker	tracker

Method Summary

static void	centerWindowOnComponent(java.awt.Window window, java.awt.Component over) Centers the window over a component (usually another window).
static javax.swing.ImageIcon	createImageIcon(java.awt.Image image)
static javax.swing.ImageIcon	createImageIcon(java.net.URL url) Create an image icon from the specified URL.
static void	drawHighlightBorder(java.awt.Graphics g, int x, int y, int width, int height, boolean raised, java.awt.Color shadow, java.awt.Color highlight) Draws a single-line highlight border rectangle.
static java.awt.Component	focusComponentOrChild(java.awt.Component c) Puts the focus on the first component in the tree of c that can accept the focus.
static javax.swing.JComponent	focusComponentOrChild(java.awt.Component c, boolean deepest) Puts the focus on the first component in the tree of c that can accept the focus.
static java.awt.Component	getFocusableComponentOrChild(java.awt.Component c) Deprecated. replaced by getFocusableComponentOrChild(Component, boolean)
static javax.swing.JComponent	getFocusableComponentOrChild(java.awt.Component c, boolean deepest) Returns the first component in the tree of c that can accept the focus.
static java.awt.Component	getFocusedChildComponent(java.awt.Component c)
static java.awt.Insets	getHighlightBorderInsets() Return the amount of space taken up by a highlight border drawn by drawHighlightBorder().
static java.lang.String[]	getImageExtensions() Returns an array of extenstions for available images.
static java.awt.Point	getPopupMenuShowPoint(javax.swing.JPopupMenu popup, int x, int y) Returns a point where the given popup menu should be shown.
static java.awt.Point	getPopupMenuShowPoint(javax.swing.JPopupMenu popup, java.awt.event.MouseEvent event) Returns a point where the given popup menu should be shown.
static java.awt.Rectangle[]	getScreenBounds()
static boolean	isAncestorOfFocusedComponent(java.awt.Component c)
static java.awt.Image	loadFromResource(java.lang.String imageName, java.lang.Class cls) Loads an Image named imageName as a resource relative to the Class cls.

Methods inherited from class oracle.javatools.util.GraphicsUtils

centerWindowOnScreen

Methods inherited from class java.lang.Object

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

Field Detail

component

protected static final java.awt.Component component

tracker

protected static final java.awt.MediaTracker tracker

Method Detail

drawHighlightBorder

public static void drawHighlightBorder(java.awt.Graphics g,
                                       int x,
                                       int y,
                                       int width,
                                       int height,
                                       boolean raised,
                                       java.awt.Color shadow,
                                       java.awt.Color highlight)

Draws a single-line highlight border rectangle.

Parameters:

g - The graphics context to use for drawing.

x - The left edge of the border.

y - The top edge of the border.

width - The width of the border.

height - The height of the border.

raised - true if the border is to be drawn raised, false if lowered.

shadow - The shadow color for the border.

highlight - The highlight color for the border.

See Also:

EtchedBorder, BasicGraphicsUtils.drawEtchedRect(java.awt.Graphics, int, int, int, int, java.awt.Color, java.awt.Color, java.awt.Color, java.awt.Color)

getHighlightBorderInsets

public static java.awt.Insets getHighlightBorderInsets()

Return the amount of space taken up by a highlight border drawn by drawHighlightBorder().

Returns:

The Insets needed for the highlight border.

See Also:

drawHighlightBorder(java.awt.Graphics, int, int, int, int, boolean, java.awt.Color, java.awt.Color)

createImageIcon

public static javax.swing.ImageIcon createImageIcon(java.net.URL url)

Create an image icon from the specified URL. Ensures that addin policy violations are checked.

Parameters:

url - the url to load an image icon for

Returns:

the image icon.

createImageIcon

public static javax.swing.ImageIcon createImageIcon(java.awt.Image image)

getPopupMenuShowPoint

public static java.awt.Point getPopupMenuShowPoint(javax.swing.JPopupMenu popup,
                                                   java.awt.event.MouseEvent event)

Returns a point where the given popup menu should be shown. The point is calculated by adjusting the X and Y coordinates from the given mouse event so that the popup menu will not be clipped by the screen boundaries.

Parameters:

popup - the popup menu

event - the mouse event

Returns:

the point where the popup menu should be shown

getPopupMenuShowPoint

public static java.awt.Point getPopupMenuShowPoint(javax.swing.JPopupMenu popup,
                                                   int x,
                                                   int y)

Returns a point where the given popup menu should be shown. The point is calculated by adjusting the X and Y coordinates so that the popup menu will not be clipped by the screen boundaries.

Parameters:

popup - the popup menu

x - the x position in screen coordinate

y - the y position in screen coordinates

Returns:

the point where the popup menu should be shown in screen coordinates

centerWindowOnComponent

public static void centerWindowOnComponent(java.awt.Window window,
                                           java.awt.Component over)

Centers the window over a component (usually another window). The window must already have been sized.

isAncestorOfFocusedComponent

public static boolean isAncestorOfFocusedComponent(java.awt.Component c)

Returns:

returns true if the component of one of its child has the focus

getFocusedChildComponent

public static java.awt.Component getFocusedChildComponent(java.awt.Component c)

Returns:

the child component that has the focus or null if the focus is not under c

getFocusableComponentOrChild

public static java.awt.Component getFocusableComponentOrChild(java.awt.Component c)

Deprecated. replaced by getFocusableComponentOrChild(Component, boolean)

Returns the first component in the tree of c that can accept the focus.

Parameters:

c - the root of the component hierarchy to search

See Also:

focusComponentOrChild(java.awt.Component)

getFocusableComponentOrChild

public static javax.swing.JComponent getFocusableComponentOrChild(java.awt.Component c,
                                                                  boolean deepest)

Returns the first component in the tree of c that can accept the focus.

Parameters:

c - the root of the component hierarchy to search

deepest - if deepest is true the method will return the first and deepest component that can accept the focus. For example, if both a child and its parent are focusable and deepest is true, the child is returned.

See Also:

focusComponentOrChild(java.awt.Component)

focusComponentOrChild

public static java.awt.Component focusComponentOrChild(java.awt.Component c)

Puts the focus on the first component in the tree of c that can accept the focus.

See Also:

getFocusableComponentOrChild(java.awt.Component)

focusComponentOrChild

public static javax.swing.JComponent focusComponentOrChild(java.awt.Component c,
                                                           boolean deepest)

Puts the focus on the first component in the tree of c that can accept the focus.

Parameters:

c - the root of the component hierarchy to search

deepest - if deepest is true the method will focus the first and deepest component that can accept the focus. For example, if both a child and its parent are focusable and deepest is true, the child is focused.

See Also:

getFocusableComponentOrChild(java.awt.Component)

loadFromResource

public static java.awt.Image loadFromResource(java.lang.String imageName,
                                              java.lang.Class cls)

Loads an Image named imageName as a resource relative to the Class cls. If the Image can not be loaded, then null is returned. Images loaded here will be added to an internal cache based upon the full URL to their location. This method replaces legacy code from JDeveloper 3.x and earlier.

See Also:

Class.getResource(String), Toolkit.createImage(URL)

getScreenBounds

public static java.awt.Rectangle[] getScreenBounds()

getImageExtensions

public static java.lang.String[] getImageExtensions()

Returns an array of extenstions for available images. On Windows JDK 1.4.1 this would return { ".gif", ".jpg", ".jpeg", ".png" }