Java(TM) 2 Platform, Standard Edition, v1.2.2 API Specification: Class SwingUtilities - JDK 5 Documentation v1.2.2, Java 2 SDK 英文文档

convertPointToScreen

public static void convertPointToScreen(Point p,
                                        Component c)

Convert a point from a component's coordinate system to screen coordinates.

Parameters:

p - a Point object (converted to the new coordinate system)

c - a Component object

convertPointFromScreen

public static void convertPointFromScreen(Point p,
                                          Component c)

Convert a point from a screen coordinates to a component's coordinate system

Parameters:

p - a Point object (converted to the new coordinate system)

c - a Component object

windowForComponent

public static Window windowForComponent(Component aComponent)

Return aComponent's window

isDescendingFrom

public static boolean isDescendingFrom(Component a,
                                       Component b)

Return true if a component a descends from a component b

computeIntersection

public static Rectangle computeIntersection(int x,
                                            int y,
                                            int width,
                                            int height,
                                            Rectangle dest)

Convenience to calculate an intersection of two rectangles without allocating a new rectangle Return dest.

computeUnion

public static Rectangle computeUnion(int x,
                                     int y,
                                     int width,
                                     int height,
                                     Rectangle dest)

Convenience to calculate the union of two rectangles without allocating a new rectangle Return dest

computeDifference

public static Rectangle[] computeDifference(Rectangle rectA,
                                            Rectangle rectB)

Convenience returning an array of rect representing the regions within rectA that do not overlap with rectB. If the two Rects do not overlap, returns an empty array

isLeftMouseButton

public static boolean isLeftMouseButton(MouseEvent anEvent)

Returns true if the mouse event specifies the left mouse button.

Parameters:

anEvent - a MouseEvent object

Returns:

true if the left mouse button was active

isMiddleMouseButton

public static boolean isMiddleMouseButton(MouseEvent anEvent)

Returns true if the mouse event specifies the middle mouse button.

Parameters:

anEvent - a MouseEvent object

Returns:

true if the middle mouse button was active

isRightMouseButton

public static boolean isRightMouseButton(MouseEvent anEvent)

Returns true if the mouse event specifies the right mouse button.

Parameters:

anEvent - a MouseEvent object

Returns:

true if the right mouse button was active

computeStringWidth

public static int computeStringWidth(FontMetrics fm,
                                     String str)

Compute the width of the string using a font with the specified "metrics" (sizes).

Parameters:

fm - a FontMetrics object to compute with

str - the String to compute

Returns:

an int containing the string width

layoutCompoundLabel

public static String layoutCompoundLabel(JComponent c,
                                         FontMetrics fm,
                                         String text,
                                         Icon icon,
                                         int verticalAlignment,
                                         int horizontalAlignment,
                                         int verticalTextPosition,
                                         int horizontalTextPosition,
                                         Rectangle viewR,
                                         Rectangle iconR,
                                         Rectangle textR,
                                         int textIconGap)

Compute and return the location of the icons origin, the location of origin of the text baseline, and a possibly clipped version of the compound labels string. Locations are computed relative to the viewR rectangle. The JComponents orientation (LEADING/TRAILING) will also be taken into account and translated into LEFT/RIGHT values accordingly.

layoutCompoundLabel

public static String layoutCompoundLabel(FontMetrics fm,
                                         String text,
                                         Icon icon,
                                         int verticalAlignment,
                                         int horizontalAlignment,
                                         int verticalTextPosition,
                                         int horizontalTextPosition,
                                         Rectangle viewR,
                                         Rectangle iconR,
                                         Rectangle textR,
                                         int textIconGap)

Compute and return the location of the icons origin, the location of origin of the text baseline, and a possibly clipped version of the compound labels string. Locations are computed relative to the viewR rectangle. This layoutCompoundLabel() does not know how to handle LEADING/TRAILING values in horizontalTextPosition (they will default to RIGHT) and in horizontalAlignment (they will default to CENTER). Use the other version of layoutCompoundLabel() instead.

paintComponent

public static void paintComponent(Graphics g,
                                  Component c,
                                  Container p,
                                  int x,
                                  int y,
                                  int w,
                                  int h)

Paint a component c on an abitrary graphics g in the specified rectangle, specifying the rectangle's upper left corner and size. The component is reparented to a private container (whose parent becomes p) which prevents c.validate() and and c.repaint() calls from propogating up the tree. The intermediate container has no other effect.

Parameters:

g - the Graphics object to draw on

c - the Component to draw

p - the intermedate Container

x - an int specifying the left side of the area draw in, in pixels, measured from the left edge of the graphics context

y - an int specifying the top of the area to draw in, in pixels measured down from the top edge of the graphics context

w - an int specifying the width of the area draw in, in pixels

h - an int specifying the height of the area draw in, in pixels

paintComponent

public static void paintComponent(Graphics g,
                                  Component c,
                                  Container p,
                                  Rectangle r)

Paint a component c on an abitrary graphics g in the specified rectangle, specifying a Rectangle object. The component is reparented to a private container (whose parent becomes p) which prevents c.validate() and and c.repaint() calls from propogating up the tree. The intermediate container has no other effect.

Parameters:

g - the Graphics object to draw on

c - the Component to draw

p - the intermedate Container

r - the Rectangle to draw in

updateComponentTreeUI

public static void updateComponentTreeUI(Component c)

A simple minded look and feel change: ask each node in the tree to updateUI(), i.e. to initialize its UI property with the current look and feel.

invokeLater

public static void invokeLater(Runnable doRun)

Causes doRun.run() to be executed asynchronously on the AWT event dispatching thread. This will happen after all pending AWT events have been processed. This method should be used when an application thread needs to update the GUI. In the following example the invokeAndWait() calls queues the doHelloWorld Runnable for the event dispatching thread and then prints a message.

 Runnable doHelloWorld = new Runnable() {
     public void run() {
         System.out.println("Hello World on " + Thread.currentThread());
     }
 };

 SwingUtilities.invokeAndWait(doHelloWorld);
 System.out.println("Waiting ... ");
 

If invokeAndWait is called from the event dispatching thread, e.g. from a JButtons ActionListener, the doRun.run() will still be deferred till all pending events have been processed. Note that if the doRun.run() throws an uncaught exception the event dispatching thread will unwind (not the current thread).

Additional documentation and examples for this method can be found in .

See Also:

invokeAndWait(java.lang.Runnable)

invokeAndWait

public static void invokeAndWait(Runnable doRun)
                          throws InterruptedException,
                                 InvocationTargetException

Causes doRun.run() to be executed synchronously on the AWT event dispatching thread. This call will block until all pending AWT events have been processed and (then) doRun.run() returns. This method should be used when an application thread needs to update the GUI. It should not be called from the EventDispatchThread. Here's an example that creates a new application thread that uses invokeAndWait() to print a string from the event dispatching thread and then, when that's finished, print a string from the application thread.

 final Runnable doHelloWorld = new Runnable() {
     public void run() {
         System.out.println("Hello World on " + Thread.currentThread());
     }
 };

 Thread appThread = new Thread() {
     public void run() {
         try {
             SwingUtilities.invokeAndWait(doHelloWorld);
         }
         catch (Exception e) {
             e.printStackTrace();
         }
         System.out.println("Finished on " + Thread.currentThread());
     }
 };
 appThread.start();
 

Note that if the Runnable.run() method throws an uncaught exception (on the event dispatching thread) it's caught and rethrown, as an InvocationTargetException, on the callers thread.

Additional documentation and examples for this method can be found in .

Throws:

InterruptedException - If we're interrupted while waiting for the event dispatching thread to finish excecuting doRun.run()

InvocationTargetException - If doRun.run() throws

See Also:

invokeLater(java.lang.Runnable)

isEventDispatchThread

public static boolean isEventDispatchThread()

Returns true if the current thread is an AWT event dispatching thread.

Returns:

true if the current thread is an AWT event dispatching thread

getAccessibleIndexInParent

public static int getAccessibleIndexInParent(Component c)

Get the index of this object in its accessible parent.

Returns:

-1 of this object does not have an accessible parent. Otherwise, the index of the child in its accessible parent.

getAccessibleAt

public static Accessible getAccessibleAt(Component c,
                                         Point p)

Returns the Accessible child contained at the local coordinate Point, if one exists.

Returns:

the Accessible at the specified location, if it exists

getAccessibleStateSet

public static AccessibleStateSet getAccessibleStateSet(Component c)

Get the state of this object.

Returns:

an instance of AccessibleStateSet containing the current state set of the object

See Also:

AccessibleState

getAccessibleChildrenCount

public static int getAccessibleChildrenCount(Component c)

Returns the number of accessible children in the object. If all of the children of this object implement Accessible, than this method should return the number of children of this object.

Returns:

the number of accessible children in the object.

getAccessibleChild

public static Accessible getAccessibleChild(Component c,
                                            int i)

Return the nth Accessible child of the object.

Parameters:

i - zero-based index of child

Returns:

the nth Accessible child of the object

findFocusOwner

public static Component findFocusOwner(Component c)

Return the child component which has focus, if any. The HotJava SecurityManager forbids applet access to getFocusOwner(), so if the component is an applet, we check whether a JComponent has focus. Non-Swing components in an applet on HotJava are out-of-luck, unfortunately.

getRootPane

public static JRootPane getRootPane(Component c)

If c is a JRootPane descendant return its JRootPane ancestor. If c is a RootPaneContainer then return its JRootPane.

Returns:

the JRootPane for Component c or null.

getRoot

public static Component getRoot(Component c)

Returns the root component for the current component tree.

Returns:

the first ancestor of c that's a Window or the last Applet ancestor