Stores the position and size of the inner painting area of the specified component in r and returns r.

  Stores the position and size of
the inner painting area of the specified component
in r and returns r.
The position and size specify the bounds of the component,
adjusted so as not to include the border area (the insets).
This method is useful for classes
that implement painting code.
Returns: {@code null} if the Component is {@code null}; otherwise, returns the passed-in rectangle (if non-{@code null}) or a new rectangle specifying position and size information
Parameters:
- c - the JComponent in question; if {@code null}, this method returns {@code null}
- r - the Rectangle instance to be modified; may be {@code null}
Since: 1.4

  Convenience returning an array of rect representing the regions within rectA that do not overlap with 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

  Convenience to calculate the intersection of two rectangles without allocating a new rectangle.

  Convenience to calculate the intersection of two rectangles
without allocating a new rectangle.
If the two rectangles don't intersect,
then the returned rectangle begins at (0,0)
and has zero width and height.
Returns: dest, modified to specify the intersection
Parameters:
- x - the X coordinate of the first rectangle's top-left point
- y - the Y coordinate of the first rectangle's top-left point
- width - the width of the first rectangle
- height - the height of the first rectangle
- dest - the second rectangle

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

  Compute the width of the string using a font with the specified
"metrics" (sizes).
Returns: an int containing the string width
Parameters:
- fm - a FontMetrics object to compute with
- str - the String to compute

  Convenience method that calculates the union of two rectangles without allocating a new rectangle.

  Convenience method that calculates the union of two rectangles
without allocating a new rectangle.
Returns: the dest Rectangle
Parameters:
- x - the x-coordinate of the first rectangle
- y - the y-coordinate of the first rectangle
- width - the width of the first rectangle
- height - the height of the first rectangle
- dest - the coordinates of the second rectangle; the union of the two rectangles is returned in this rectangle

  Returns a MouseEvent similar to sourceEvent except that its x and y members have been converted to destination's coordinate system.

  Returns a MouseEvent similar to sourceEvent except that its x
and y members have been converted to destination's coordinate
system. If source is null, sourceEvent x and y members
are assumed to be into destination's root component coordinate system.
If destination is null, the
returned MouseEvent will be in source's coordinate system.
sourceEvent will not be changed. A new event is returned.
the source field of the returned event will be set
to destination if destination is non-null
use the translateMouseEvent() method to translate a mouse event from
one component to another without changing the source.

  Convert the point (x,y) in source coordinate system to destination coordinate system.

  Convert the point (x,y) in source coordinate system to
destination coordinate system.
If source is null, (x,y) is assumed to be in destination's
root component coordinate system.
If destination is null, (x,y) will be converted to source's
root component coordinate system.
If both source and destination are null, return (x,y)
without any conversion.

  Convert a aPoint in source coordinate system to destination coordinate system.

  Convert a aPoint in source coordinate system to
destination coordinate system.
If source is null, aPoint is assumed to be in destination's
root component coordinate system.
If destination is null, aPoint will be converted to source's
root component coordinate system.
If both source and destination are null, return aPoint
without any conversion.

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

  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

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

  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

  Convert the rectangle aRectangle in source coordinate system to destination coordinate system.

  Convert the rectangle aRectangle in source coordinate system to
destination coordinate system.
If source is null, aRectangle is assumed to be in destination's
root component coordinate system.
If destination is null, aRectangle will be converted to source's
root component coordinate system.
If both source and destination are null, return aRectangle
without any conversion.

Converts the location x y to the parents coordinate system, returning the location.

Returns true if the Icon icon is an instance of ImageIcon, and the image it contains is the same as image.

  Returns index of the first occurrence of mnemonic within string text.

  Returns index of the first occurrence of mnemonic
within string text. Matching algorithm is not
case-sensitive.
Returns: index into the string if exists, otherwise -1
Parameters:
- text - The text to search through, may be {@code null}
- mnemonic - The mnemonic to find the character for.

  Return the child Component of the specified Component that is the focus owner, if any.

  Return the child Component of the specified
Component that is the focus owner, if any.
Returns: the focus owner, or null if there is no focus owner, or if the focus owner is not comp, or a descendant of comp
Parameters:
- c - the root of the Component hierarchy to search for the focus owner
See Also: KeyboardFocusManager.getFocusOwner(),

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

  Returns the Accessible child contained at the
local coordinate Point, if one exists.
Otherwise returns null.
Returns: the Accessible at the specified location, if it exists; otherwise null

  Return the nth Accessible child of the object.

  Return the nth Accessible child of the object.

Note: as of the Java 2 platform v1.3, it is recommended that developers call Component.AccessibleAWTComponent.getAccessibleIndexInParent() instead of using this method.
Returns: the nth Accessible child of the object
Parameters:
- i - zero-based index of child

  Returns the number of accessible children in the object.

  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.

Note: as of the Java 2 platform v1.3, it is recommended that developers call Component.AccessibleAWTComponent.getAccessibleIndexInParent() instead of using this method.
Returns: the number of accessible children in the object.

  Get the index of this object in its accessible parent.

  Get the index of this object in its accessible parent.

Note: as of the Java 2 platform v1.3, it is recommended that developers call Component.AccessibleAWTComponent.getAccessibleIndexInParent() instead of using this method.
Returns: -1 of this object does not have an accessible parent. Otherwise, the index of the child in its accessible parent.

  Get the state of this object.

  Get the state of this object.

Note: as of the Java 2 platform v1.3, it is recommended that developers call Component.AccessibleAWTComponent.getAccessibleIndexInParent() instead of using this method.
Returns: an instance of AccessibleStateSet containing the current state set of the object
See Also: AccessibleState,

  Convenience method for searching above comp in the component hierarchy and returns the first object of name it finds.

  Convenience method for searching above comp in the
component hierarchy and returns the first object of name it
finds. Can return null, if name cannot be found.

  Convenience method for searching above comp in the component hierarchy and returns the first object of class c it finds.

  Convenience method for searching above comp in the
component hierarchy and returns the first object of class c it
finds. Can return null, if a class c cannot be found.

  Returns the deepest visible descendent Component of parent that contains the location x, y.

  Returns the deepest visible descendent Component of parent
that contains the location x, y.
If parent does not contain the specified location,
then null is returned. If parent is not a
container, or none of parent's visible descendents
contain the specified location, parent is returned.
Parameters:
- parent - the root component to begin the search
- x - the x target location
- y - the y target location

Return the rectangle (0,0,bounds.width,bounds.height) for the component aComponent

  Returns the root component for the current component tree.

  Returns the root component for the current component tree.
Returns: the first ancestor of c that's a Window or the last Applet ancestor

  If c is a JRootPane descendant return its JRootPane ancestor.

  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 {@code null}.

  Returns a toolkit-private, shared, invisible Frame to be the owner for JDialogs and JWindows created with null owners.

  Returns a toolkit-private, shared, invisible Frame
to be the owner for JDialogs and JWindows created with
null owners.
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true.
See Also: GraphicsEnvironment.isHeadless(),

  Returns a SharedOwnerFrame's shutdown listener to dispose the SharedOwnerFrame if it has no more displayable children.

  Returns a SharedOwnerFrame's shutdown listener to dispose the SharedOwnerFrame
if it has no more displayable children.
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true.
See Also: GraphicsEnvironment.isHeadless(),

  Returns the ActionMap provided by the UI in component component.

  Returns the ActionMap provided by the UI in component component.

This will return null if the UI has not installed an ActionMap.
Since: 1.3

  Returns the InputMap provided by the UI for condition condition in component component.

  Returns the InputMap provided by the UI for condition condition in component component.

This will return null if the UI has not installed a InputMap of the specified type.
Since: 1.3

  Returns the first Window ancestor of c, or null if c is not contained inside a Window.

  Returns the first Window ancestor of c, or
null if c is not contained inside a Window.
Returns: the first Window ancestor of c, or {@code null} if c is not contained inside a Window.
Parameters:
- c - Component to get Window ancestor of.
Since: 1.3

Installs a DropTarget on the component as necessary for a TransferHandler change.

  Causes doRun.run() to be executed synchronously on the AWT event dispatching thread.

  Causes doRun.run() to be executed synchronously on the AWT event dispatching thread. This call blocks 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'nt 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 caller's thread.

Additional documentation and examples for this method can be found in How to Use Threads, in The Java Tutorial.

As of 1.3 this method is just a cover for java.awt.EventQueue.invokeAndWait().
Throws:
- InterruptedException - if we're interrupted while waiting for the event dispatching thread to finish excecuting doRun.run()
- InvocationTargetException - if an exception is thrown while running doRun
See Also: SwingUtilities.invokeLater(java.lang.Runnable),

  Causes doRun.run() to be executed asynchronously on the AWT event dispatching thread.

  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 invokeLater call queues the Runnable object doHelloWorld on 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.invokeLater(doHelloWorld);
 System.out.println("This might well be displayed before the other message.");
 

If invokeLater is called from the event dispatching thread -- for example, from a JButton's ActionListener -- the doRun.run() will still be deferred until 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 How to Use Threads, in The Java Tutorial.

As of 1.3 this method is just a cover for java.awt.EventQueue.invokeLater().

Unlike the rest of Swing, this method can be invoked from any thread.
See Also: SwingUtilities.invokeAndWait(java.lang.Runnable),

Return true if a component a descends from a component b

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

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

As of 1.3 this method is just a cover for java.awt.EventQueue.isDispatchThread().
Returns: true if the current thread is an AWT event dispatching thread

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

  Returns true if the mouse event specifies the left mouse button.
Returns: true if the left mouse button was active
Parameters:
- anEvent - a MouseEvent object

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

  Returns true if the mouse event specifies the middle mouse button.
Returns: true if the middle mouse button was active
Parameters:
- anEvent - a MouseEvent object

Return true if a contains b

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

  Returns true if the mouse event specifies the right mouse button.
Returns: true if the right mouse button was active
Parameters:
- anEvent - a MouseEvent object

Returns true if the e is a valid KeyEvent to use in processing the key bindings associated with JComponents.

  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.

  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.

  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.

  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.

  Invokes actionPerformed on action if action is enabled (and non-null).

  Invokes actionPerformed on action if
action is enabled (and non-null). The command for the
ActionEvent is determined by:

1. If the action was registered via
   registerKeyboardAction, then the command string
   passed in (null will be used if null was passed in).
   
2. Action value with name Action.ACTION_COMMAND_KEY, unless null.
   
3. String value of the KeyEvent, unless getKeyChar
   returns KeyEvent.CHAR_UNDEFINED..
   

This will return true if action is non-null and
actionPerformed is invoked on it.
Since: 1.3

  Paints a component to the specified Graphics.

  Paints a component to the specified Graphics. This method is primarily useful to render Components that don't exist as part of the visible containment hierarchy, but are used for rendering. For example, if you are doing your own rendering and want to render some text (or even HTML), you could make use of JLabel's text rendering support and have it paint directly by way of this method, without adding the label to the visible containment hierarchy.

This method makes use of CellRendererPane to handle the actual painting, and is only recommended if you use one component for rendering. If you make use of multiple components to handle the rendering, as JTable does, use CellRendererPane directly. Otherwise, as described below, you could end up with a CellRendererPane per Component.

If c's parent is not a CellRendererPane, a new CellRendererPane is created, c is added to it, and the CellRendererPane is added to p. If c's parent is a CellRendererPane and the CellRendererPanes parent is not p, it is added to p.

The component should either descend from JComponent or be another kind of lightweight component. A lightweight component is one whose "lightweight" property (returned by the Component isLightweight method) is true. If the Component is not lightweight, bad things map happen: crashes, exceptions, painting problems...
Parameters:
- g - the Graphics object to draw on
- c - the Component to draw
- p - the intermediate 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
See Also: CellRendererPane, Component.isLightweight(),

  Paints a component to the specified Graphics.

  Paints a component to the specified Graphics. This
is a cover method for
SwingUtilities.paintComponent(Graphics,Component,Container,int,int,int,int).
Refer to it for more information.
Parameters:
- g - the Graphics object to draw on
- c - the Component to draw
- p - the intermediate Container
- r - the Rectangle to draw in
See Also: SwingUtilities.paintComponent(Graphics,Component,Container,int,int,int,int), CellRendererPane,

  Process the key bindings for the Component associated with event.

  Process the key bindings for the Component associated with
event. This method is only useful if
event.getComponent() does not descend from
JComponent, or your are not invoking
super.processKeyEvent from within your
JComponent subclass. JComponent
automatically processes bindings from within its
processKeyEvent method, hence you rarely need
to directly invoke this method.
Returns: true if a binding has found and processed
Parameters:
- event - KeyEvent used to identify which bindings to process, as well as which Component has focus.
Since: 1.4

  Convenience method to change the UI ActionMap for component to uiActionMap.

  Convenience method to change the UI ActionMap for component
to uiActionMap. If uiActionMap is null,
this removes any previously installed UI ActionMap.
Since: 1.3

  Convenience method to change the UI InputMap for component to uiInputMap.

  Convenience method to change the UI InputMap for component
to uiInputMap. If uiInputMap is null,
this removes any previously installed UI InputMap.
Since: 1.3

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

  Returns the first Window ancestor of c, or null if c is not contained inside a Window.

  Returns the first Window ancestor of c, or null if c is not contained inside a Window.

Note: This method provides the same functionality as getWindowAncestor.
Returns: the first Window ancestor of c, or {@code null} if c is not contained inside a Window.
Parameters:
- c - Component to get Window ancestor of.