javax.swing

Class JComponent

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent

Implemented Interfaces:: ImageObserver, MenuContainer, Serializable

Known Direct Subclasses:: AbstractButton, BasicInternalFrameTitlePane, Box, Box.Filler, JColorChooser, JComboBox, JFileChooser, JInternalFrame, JInternalFrame.JDesktopIcon, JLabel, JLayeredPane, JList, JMenuBar, JOptionPane, JPanel, JPopupMenu, JProgressBar, JRootPane, JScrollBar, JScrollPane, JSeparator, JSlider, JSpinner, JSplitPane, JTabbedPane, JTable, JTableHeader, JTextComponent, JToolBar, JToolTip, JTree, JViewport

public abstract class JComponent

extends Container

implements Serializable

The base class of all Swing components. It contains generic methods to manage events, properties and sizes. Actual drawing of the component is channeled to a look-and-feel class that is implemented elsewhere.

See Also:: Serialized Form

Nested Class Summary
`abstract class`	`JComponent.AccessibleJComponent` Basic accessibility support for `JComponent` derived widgets.

Nested classes/interfaces inherited from class java.awt.Container
`Container.AccessibleAWTContainer`

Nested classes/interfaces inherited from class java.awt.Component
`Component.AccessibleAWTComponent`, `Component.BltBufferStrategy`, `Component.FlipBufferStrategy`

Field Summary
`static String`	`TOOL_TIP_TEXT_KEY`
`static int`	`UNDEFINED_CONDITION` Constant used to indicate that no condition has been assigned to a particular action.
`static int`	`WHEN_ANCESTOR_OF_FOCUSED_COMPONENT` Constant used to indicate that an action should be performed only when the component is an ancestor of the component which has focus.
`static int`	`WHEN_FOCUSED` Constant used to indicate that an action should be performed only when the component has focus.
`static int`	`WHEN_IN_FOCUSED_WINDOW` Constant used to indicate that an action should be performed only when the component is in the window which has focus.
`protected AccessibleContext`	`accessibleContext` The accessible context of this `JComponent`.
`protected EventListenerList`	`listenerList` Listeners for events other than `PropertyChangeEvent` are handled by this listener list.
`protected ComponentUI`	`ui` The user interface delegate for this component.

Fields inherited from class java.awt.Component
`BOTTOM_ALIGNMENT`, `CENTER_ALIGNMENT`, `LEFT_ALIGNMENT`, `RIGHT_ALIGNMENT`, `TOP_ALIGNMENT`

Fields inherited from interface java.awt.image.ImageObserver
`ABORT`, `ALLBITS`, `ERROR`, `FRAMEBITS`, `HEIGHT`, `PROPERTIES`, `SOMEBITS`, `WIDTH`

Constructor Summary
`JComponent()` Creates a new `JComponent` instance.

Method Summary
`void`	`addAncestorListener(AncestorListener listener)` Register an `AncestorListener`.
`void`	`addNotify()` Receives notification if this component is added to a parent component.
`void`	`addVetoableChangeListener(VetoableChangeListener listener)` Register a `VetoableChangeListener`.
`void`	`computeVisibleRect(Rectangle rect)` Compute the component's visible rectangle, which is defined recursively as either the component's bounds, if it has no parent, or the intersection of the component's bounds with the visible rectangle of its parent.
`boolean`	`contains(int x, int y)` Returns `true` if the coordinates (x, y) lie within the bounds of this component and `false` otherwise.
`JToolTip`	`createToolTip()` Return the `toolTip` property of this component, creating it and setting it if it is currently `null`.
`void`	`disable()` Deprecated. replaced by `setEnabled(boolean)`
`void`	`enable()` Deprecated. replaced by `setEnabled(boolean)`
	`extends EventListener> T[] getListeners(Class listenerType)` Returns all registered `EventListener`s of the given `listenerType`.
`void`	`firePropertyChange(String property, boolean oldValue, boolean newValue)` Fires a property change for a primitive boolean property.
`void`	`firePropertyChange(String property, int oldValue, int newValue)` Fires a property change for a primitive integer property.
`protected void`	`fireVetoableChange(String propertyName, Object oldValue, Object newValue)` Call `VetoableChangeListener.vetoableChange(PropertyChangeEvent)` on all listeners registered to listen to a given property.
`AccessibleContext`	`getAccessibleContext()` Get the value of the accessibleContext property for this component.
`ActionListener`	`getActionForKeyStroke(KeyStroke ks)` Get the ActionListener (typically an `Action` object) which is associated with a particular keystroke.
`ActionMap`	`getActionMap()`
`float`	`getAlignmentX()` Get the value of the `alignmentX` property.
`float`	`getAlignmentY()` Get the value of the `alignmentY` property.
`AncestorListener[]`	`getAncestorListeners()` Return all registered `AncestorListener` objects.
`boolean`	`getAutoscrolls()` Get the current value of the `autoscrolls` property.
`Border`	`getBorder()` Get the value of the `border` property.
`Rectangle`	`getBounds(Rectangle rv)` Get the component's current bounding box.
`Object`	`getClientProperty(Object key)` Get a client property associated with this component and a particular key.
`protected Graphics`	`getComponentGraphics(Graphics g)` Prepares a graphics context for painting this object.
`JPopupMenu`	`getComponentPopupMenu()` Returns the popup menu for this component.
`int`	`getConditionForKeyStroke(KeyStroke ks)` Return the condition that determines whether a registered action occurs in response to the specified keystroke.
`int`	`getDebugGraphicsOptions()` Get the value of the `debugGraphicsOptions` property.
`static Locale`	`getDefaultLocale()` Returns the locale used as the default for all new components.
`Graphics`	`getGraphics()` Returns the Graphics context for this component.
`int`	`getHeight()` Returns the height of this component.
`boolean`	`getInheritsPopupMenu()` Returns the flag that controls whether or not the component inherits its parent's popup menu when no popup menu is specified for this component.
`InputMap`	`getInputMap()` Returns the input map associated with this component for the `WHEN_FOCUSED` state.
`InputMap`	`getInputMap(int condition)` Returns the input map associated with this component for the given state/condition.
`InputVerifier`	`getInputVerifier()` Returns the currently set input verifier for this component.
`Insets`	`getInsets()` Get the component's insets, which are calculated from the `border` property.
`Insets`	`getInsets(Insets insets)` Get the component's insets, which are calculated from the `border` property.
`Point`	`getLocation(Point rv)` Get the component's location.
`Dimension`	`getMaximumSize()` Get the component's maximum size.
`Dimension`	`getMinimumSize()` Get the component's minimum size.
`Component`	`getNextFocusableComponent()` Deprecated. See `FocusTraversalPolicy`
`Dimension`	`getPreferredSize()` Get the component's preferred size.
`KeyStroke[]`	`getRegisteredKeyStrokes()` Return the set of `KeyStroke` objects which are registered to initiate actions on this component.
`JRootPane`	`getRootPane()` Returns the first ancestor of this component which is a `JRootPane`.
`Dimension`	`getSize(Dimension rv)` Get the component's size.
`Point`	`getToolTipLocation(MouseEvent event)` Return the location at which the `toolTipText` property should be displayed, when triggered by a particular mouse event.
`String`	`getToolTipText()` Returns the current tooltip text for this component, or `null` if none has been set.
`String`	`getToolTipText(MouseEvent event)` Returns the tooltip text for this component for a particular mouse event.
`Container`	`getTopLevelAncestor()` Return the top level ancestral container (usually a `Window` or `Applet`) which this component is contained within, or `null` if no ancestors exist.
`TransferHandler`	`getTransferHandler()` Get the value of the `transferHandler` property.
`String`	`getUIClassID()` Get the value of the UIClassID property.
`boolean`	`getVerifyInputWhenFocusTarget()`
`VetoableChangeListener[]`	`getVetoableChangeListeners()` Return all registered `VetoableChangeListener` objects.
`Rectangle`	`getVisibleRect()` Return the component's visible rectangle in a new `Rectangle`, rather than via a return slot.
`int`	`getWidth()` Returns the width of this component.
`int`	`getX()` Returns the X coordinate of the upper left corner of this component.
`int`	`getY()` Returns the Y coordinate of the upper left corner of this component.
`void`	`grabFocus()` Requests that this component receive input focus, giving window focus to the top level ancestor of this component.
`boolean`	`isDoubleBuffered()` Get the value of the `doubleBuffered` property.
`static boolean`	`isLightweightComponent(Component c)` Return `true` if the provided component has no native peer; in other words, if it is a "lightweight component".
`boolean`	`isManagingFocus()` Deprecated. 1.4 Use `Component.setFocusTraversalKeys(int, Set)` and `Container.setFocusCycleRoot(boolean)` instead
`boolean`	`isOpaque()` Return the current value of the `opaque` property.
`boolean`	`isOptimizedDrawingEnabled()` Return `true` if the component can guarantee that none of its children will overlap in Z-order.
`boolean`	`isPaintingTile()` Return `true` if this component is currently painting a tile, this means that paint() is called again on another child component.
`boolean`	`isRequestFocusEnabled()` Get the value of the `requestFocusEnabled` property.
`boolean`	`isValidateRoot()` Return `true` if this component is a validation root; this will cause calls to `invalidate()` in this component's children to be "captured" at this component, and not propagate to its parents.
`void`	`paint(Graphics g)` Paint the component.
`protected void`	`paintBorder(Graphics g)` Paint the component's border.
`protected void`	`paintChildren(Graphics g)` Paint the component's children.
`protected void`	`paintComponent(Graphics g)` Paint the component's body.
`void`	`paintImmediately(int x, int y, int w, int h)` A variant of `paintImmediately(Rectangle)` which takes integer parameters.
`void`	`paintImmediately(Rectangle r)` Transform the provided dirty rectangle for this component into the appropriate ancestral `JRootPane` and call `paint(Graphics)` on that root pane.
`protected String`	`paramString()` Return a string representation for this component, for use in debugging.
`void`	`print(Graphics g)` Prints this component to the given Graphics context.
`void`	`printAll(Graphics g)` Prints this component to the given Graphics context.
`protected void`	`printBorder(Graphics g)` Print this component's border to the specified Graphics context.
`protected void`	`printChildren(Graphics g)` Print this component's children to the specified Graphics context.
`protected void`	`printComponent(Graphics g)` Prints this component to the specified Graphics context.
`protected void`	`processComponentKeyEvent(KeyEvent e)` A hook for subclasses which want to customize event processing.
`protected boolean`	`processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)`
`protected void`	`processKeyEvent(KeyEvent e)` Override the default key dispatch system from Component to hook into the swing `InputMap` / `ActionMap` system.
`protected void`	`processMouseMotionEvent(MouseEvent ev)` Processes mouse motion event, like dragging and moving.
`void`	`putClientProperty(Object key, Object value)` Add a client property `value` to this component, associated with `key`.
`void`	`registerKeyboardAction(ActionListener act, String cmd, KeyStroke stroke, int cond)` An obsolete method to register a keyboard action on this component.
`void`	`registerKeyboardAction(ActionListener act, KeyStroke stroke, int cond)` A variant of `registerKeyboardAction(ActionListener,String,KeyStroke,int)` which provides `null` for the command name.
`void`	`removeAncestorListener(AncestorListener listener)` Unregister an `AncestorListener`.
`void`	`removeNotify()` Receives notification that this component no longer has a parent.
`void`	`removeVetoableChangeListener(VetoableChangeListener listener)` Unregister a `VetoableChangeChangeListener`.
`void`	`repaint(Rectangle r)` Mark the described region of this component as dirty in the current `RepaintManager`.
`void`	`repaint(long tm, int x, int y, int width, int height)` Mark the described region of this component as dirty in the current `RepaintManager`.
`boolean`	`requestDefaultFocus()` Deprecated. Use `requestFocus()` on the default component provided from the `FocusTraversalPolicy` instead.
`void`	`requestFocus()` Requests that this component gets the input focus if the requestFocusEnabled property is set to `true`.
`boolean`	`requestFocus(boolean temporary)` This method is overridden to make it public so that it can be used by look and feel implementations.
`boolean`	`requestFocusInWindow()` Requests that this component gets the input focus if the top level window that contains this component has the focus and the requestFocusEnabled property is set to `true`.
`protected boolean`	`requestFocusInWindow(boolean temporary)` This method is overridden to make it public so that it can be used by look and feel implementations.
`void`	`resetKeyboardActions()` Reset all keyboard action registries.
`void`	`reshape(int x, int y, int w, int h)` Moves and resizes the component.
`void`	`revalidate()` Queue a an invalidation and revalidation of this component, using `RepaintManager.addInvalidComponent(JComponent)`.
`void`	`scrollRectToVisible(Rectangle r)` Calls `scrollRectToVisible` on the component's parent.
`void`	`setActionMap(ActionMap map)`
`void`	`setAlignmentX(float a)` Set the value of the `alignmentX` property.
`void`	`setAlignmentY(float a)` Set the value of the `alignmentY` property.
`void`	`setAutoscrolls(boolean a)` Set the value of the `autoscrolls` property.
`void`	`setBackground(Color bg)` Set the value of the `background` property.
`void`	`setBorder(Border newBorder)` Set the value of the `border` property.
`void`	`setComponentPopupMenu(JPopupMenu popup)` Sets the popup menu for this component (this is a bound property with the property name 'componentPopupMenu').
`void`	`setDebugGraphicsOptions(int debugOptions)` Set the value of the `debugGraphicsOptions` property.
`static void`	`setDefaultLocale(Locale l)` Sets the locale to be used as the default for all new components.
`void`	`setDoubleBuffered(boolean db)` Set the value of the `doubleBuffered` property.
`void`	`setEnabled(boolean enable)` Set the value of the `enabled` property.
`void`	`setFont(Font f)` Set the value of the `font` property.
`void`	`setForeground(Color fg)` Set the value of the `foreground` property.
`void`	`setInheritsPopupMenu(boolean inherit)` Sets the flag that controls whether or not the component inherits its parent's popup menu when no popup menu is specified for this component.
`void`	`setInputMap(int condition, InputMap map)` Sets the input map for the given condition.
`void`	`setInputVerifier(InputVerifier verifier)` Sets the input verifier to use by this component.
`void`	`setNextFocusableComponent(Component aComponent)` Deprecated. Use FocusTraversalPolicy instead
`void`	`setOpaque(boolean isOpaque)` Set if the component should paint all pixels withing its bounds.
`void`	`setRequestFocusEnabled(boolean e)` Set the value of the `requestFocusEnabled` property.
`void`	`setToolTipText(String text)` Set the tooltip text for this component.
`void`	`setTransferHandler(TransferHandler newHandler)` Set the value of the `transferHandler` property.
`protected void`	`setUI(ComponentUI newUI)` Install a new UI delegate as the component's `ui` property.
`void`	`setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)`
`void`	`setVisible(boolean v)` Set the value of the visible property.
`void`	`unregisterKeyboardAction(KeyStroke aKeyStroke)` Remove a keyboard action registry.
`void`	`update(Graphics g)` Call `paint(Graphics)`.
`void`	`updateUI()` This method should be overridden in subclasses.

add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, extends EventListener> T[] getListeners, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponentZOrder, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, extends EventListener> T[] getListeners, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFocusable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFocusable, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object
`clone`, `equals`, `extends Object> getClass`, `finalize`, `hashCode`, `notify`, `notifyAll`, `toString`, `wait`, `wait`, `wait`

TOOL_TIP_TEXT_KEY

public static final String TOOL_TIP_TEXT_KEY

Field Value:
"ToolTipText"

UNDEFINED_CONDITION

public static final int UNDEFINED_CONDITION

Constant used to indicate that no condition has been assigned to a particular action.
Field Value:
-1
See Also:
registerKeyboardAction(ActionListener,KeyStroke,int)

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

Constant used to indicate that an action should be performed only when the component is an ancestor of the component which has focus.
Field Value:
1
See Also:
registerKeyboardAction(ActionListener,KeyStroke,int)

WHEN_FOCUSED

public static final int WHEN_FOCUSED

Constant used to indicate that an action should be performed only when the component has focus.
Field Value:
0
See Also:
registerKeyboardAction(ActionListener,KeyStroke,int)

WHEN_IN_FOCUSED_WINDOW

public static final int WHEN_IN_FOCUSED_WINDOW

Constant used to indicate that an action should be performed only when the component is in the window which has focus.
Field Value:
2
See Also:
registerKeyboardAction(ActionListener,KeyStroke,int)

accessibleContext

protected AccessibleContext accessibleContext

The accessible context of this JComponent.

listenerList

protected EventListenerList listenerList

Listeners for events other than PropertyChangeEvent are handled by this listener list. PropertyChangeEvents are handled in Component.changeSupport.

ui

protected ComponentUI ui

The user interface delegate for this component. Event delivery and repainting of the component are usually delegated to this object.
See Also:
setUI(ComponentUI), getUIClassID(), updateUI()

JComponent

public JComponent()

Creates a new JComponent instance.

addAncestorListener

public void addAncestorListener(AncestorListener listener)

Register an AncestorListener.
Parameters:
listener - The listener to register
See Also:
removeVetoableChangeListener(VetoableChangeListener)

addNotify

public void addNotify()

Receives notification if this component is added to a parent component. Notification is sent to all registered AncestorListeners about the new parent. This method sets up ActionListeners for all registered KeyStrokes of this component in the chain of parent components. A PropertyChange event is fired to indicate that the ancestor property has changed. This method is used internally and should not be used in applications.
Overrides:
addNotify in interface Container

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

Register a VetoableChangeListener.
Parameters:
listener - The listener to register
See Also:
removeVetoableChangeListener(VetoableChangeListener), listenerList

computeVisibleRect

public void computeVisibleRect(Rectangle rect)

Compute the component's visible rectangle, which is defined recursively as either the component's bounds, if it has no parent, or the intersection of the component's bounds with the visible rectangle of its parent.
Parameters:
rect - The return value slot to place the visible rectangle in

contains

public boolean contains(int x,
                        int y)

Returns true if the coordinates (x, y) lie within the bounds of this component and false otherwise. x and y are relative to the coordinate space of the component.
Overrides:
contains in interface Component
Parameters:
x - the X coordinate of the point to check
y - the Y coordinate of the point to check
Returns:
true if the specified point lies within the bounds of this component, false otherwise

createToolTip

public JToolTip createToolTip()

Return the toolTip property of this component, creating it and setting it if it is currently null. This method can be overridden in subclasses which wish to control the exact form of tooltip created.
Returns:
The current toolTip

disable

public void disable()

Deprecated. replaced by setEnabled(boolean)
Disables this component.
Overrides:
disable in interface Component

enable

public void enable()

Deprecated. replaced by setEnabled(boolean)
Enables this component.
Overrides:
enable in interface Component

extends EventListener> T[] getListeners

public extends EventListener> T[] getListeners(Class listenerType)

Returns all registered EventListeners of the given listenerType.
Overrides:
extends EventListener> T[] getListeners in interface Container
Parameters:
listenerType - the class of listeners to filter (null not permitted).
Returns:
An array of registered listeners.
Throws:
ClassCastException - if listenerType does not implement the EventListener interface.
NullPointerException - if listenerType is null.
Since:
1.3
See Also:
getAncestorListeners(), listenerList

firePropertyChange

public void firePropertyChange(String property,
                               boolean oldValue,
                               boolean newValue)

Fires a property change for a primitive boolean property.
Overrides:
firePropertyChange in interface Component
Parameters:
property - the name of the property
oldValue - the old value of the property
newValue - the new value of the property

firePropertyChange

public void firePropertyChange(String property,
                               int oldValue,
                               int newValue)

Fires a property change for a primitive integer property.
Overrides:
firePropertyChange in interface Component
Parameters:
property - the name of the property
oldValue - the old value of the property
newValue - the new value of the property

fireVetoableChange

protected void fireVetoableChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)
            throws PropertyVetoException

Call VetoableChangeListener.vetoableChange(PropertyChangeEvent) on all listeners registered to listen to a given property. Any method which changes the specified property of this component should call this method.
Parameters:
propertyName - The property which changed
oldValue - The old value of the property
newValue - The new value of the property
Throws:
PropertyVetoException - if the change was vetoed by a listener
See Also:
addVetoableChangeListener(VetoableChangeListener), removeVetoableChangeListener(VetoableChangeListener)

getAccessibleContext

public AccessibleContext getAccessibleContext()

Get the value of the accessibleContext property for this component.
Overrides:
getAccessibleContext in interface Component
Returns:
the current value of the property

getActionForKeyStroke

public ActionListener getActionForKeyStroke(KeyStroke ks)

Get the ActionListener (typically an Action object) which is associated with a particular keystroke.
Parameters:
ks - The keystroke to retrieve the action of
Returns:
The action associated with the specified keystroke

getActionMap

public final ActionMap getActionMap()

getAlignmentX

public float getAlignmentX()

Get the value of the alignmentX property.
Overrides:
getAlignmentX in interface Container
Returns:
The current value of the property.
See Also:
setAlignmentX(float), alignmentY

getAlignmentY

public float getAlignmentY()

Get the value of the alignmentY property.
Overrides:
getAlignmentY in interface Container
Returns:
The current value of the property.
See Also:
setAlignmentY(float), alignmentX

getAncestorListeners

public AncestorListener[] getAncestorListeners()

Return all registered AncestorListener objects.
Returns:
The set of AncestorListener objects in listenerList

getAutoscrolls

public boolean getAutoscrolls()

Get the current value of the autoscrolls property.
Returns:
The current value of the property

getBorder

public Border getBorder()

Get the value of the border property.
Returns:
The property's current value
See Also:
setBorder(Border)

getBounds

public Rectangle getBounds(Rectangle rv)

Get the component's current bounding box. If a rectangle is provided, use this as the return value (adjusting its fields in place); otherwise (of null is provided) return a new Rectangle.
Overrides:
getBounds in interface Component
Parameters:
rv - Optional return value to use
Returns:
A rectangle bounding the component

getClientProperty

public final Object getClientProperty(Object key)

Get a client property associated with this component and a particular key.
Parameters:
key - The key with which to look up the client property
Returns:
A client property associated with this object and key
See Also:
clientProperties, JComponent, putClientProperty(Object,Object)

getComponentGraphics

protected Graphics getComponentGraphics(Graphics g)

Prepares a graphics context for painting this object. If debugGraphicsOptions is not equal to DebugGraphics.NONE_OPTION, produce a new DebugGraphics object wrapping the parameter. Otherwise configure the parameter with this component's foreground color and font.
Parameters:
g - The graphics context to wrap or configure
Returns:
A graphics context to paint this object with
See Also:
debugGraphicsOptions, paint(Graphics)

getComponentPopupMenu

public JPopupMenu getComponentPopupMenu()

Returns the popup menu for this component. If the popup menu is null AND the getInheritsPopupMenu() method returns true, this method will return the parent's popup menu (if it has one).
Returns:
The popup menu (possibly null.
Since:
1.5
See Also:
setComponentPopupMenu(JPopupMenu), getInheritsPopupMenu()

getConditionForKeyStroke

public int getConditionForKeyStroke(KeyStroke ks)

Return the condition that determines whether a registered action occurs in response to the specified keystroke. As of 1.3 KeyStrokes can be registered with multiple simultaneous conditions.
Parameters:
ks - The keystroke to return the condition of
Returns:
One of the values UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, or WHEN_IN_FOCUSED_WINDOW
See Also:
registerKeyboardAction(ActionListener,KeyStroke,int), unregisterKeyboardAction(KeyStroke), resetKeyboardActions()

getDebugGraphicsOptions

public int getDebugGraphicsOptions()

Get the value of the debugGraphicsOptions property.
Returns:
The current value of the property.
See Also:
setDebugGraphicsOptions(int), debugGraphicsOptions

getDefaultLocale

public static Locale getDefaultLocale()

Returns the locale used as the default for all new components. The default value is Locale.getDefault() (that is, the platform default locale).
Returns:
The locale (never null).
See Also:
setDefaultLocale(Locale)

getGraphics

public Graphics getGraphics()

Returns the Graphics context for this component. This can be used to draw on a component.
Overrides:
getGraphics in interface Component
Returns:
the Graphics context for this component

getHeight

public int getHeight()

Returns the height of this component. Prefer this method over getBounds(Rectangle) or getSize(Dimension) because it does not cause any heap allocation.
Overrides:
getHeight in interface Component
Returns:
the height of the component

getInheritsPopupMenu

public boolean getInheritsPopupMenu()

Returns the flag that controls whether or not the component inherits its parent's popup menu when no popup menu is specified for this component.
Returns:
A boolean.
Since:
1.5
See Also:
setInheritsPopupMenu(boolean)

getInputMap

public final InputMap getInputMap()

Returns the input map associated with this component for the WHEN_FOCUSED state.
Returns:
The input map.
Since:
1.3
See Also:
getInputMap(int)

getInputMap

public final InputMap getInputMap(int condition)

Returns the input map associated with this component for the given state/condition.
Parameters:
condition - the state (one of WHEN_FOCUSED, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT and WHEN_IN_FOCUSED_WINDOW).
Returns:
The input map.
Throws:
IllegalArgumentException - if condition is not one of the specified values.
Since:
1.3

getInputVerifier

public InputVerifier getInputVerifier()

Returns the currently set input verifier for this component.
Returns:
the input verifier, or null if none

getInsets

public Insets getInsets()

Get the component's insets, which are calculated from the border property. If the border is null, calls Container.getInsets().
Overrides:
getInsets in interface Container
Returns:
The component's current insets

getInsets

public Insets getInsets(Insets insets)

Get the component's insets, which are calculated from the border property. If the border is null, calls Container.getInsets(). The passed-in Insets value will be used as the return value, if possible.
Parameters:
insets - Return value object to reuse, if possible
Returns:
The component's current insets

getLocation

public Point getLocation(Point rv)

Get the component's location. The passed-in Point value will be used as the return value, if possible.
Overrides:
getLocation in interface Component
Parameters:
rv - Return value object to reuse, if possible
Returns:
The component's current location

getMaximumSize

public Dimension getMaximumSize()

Get the component's maximum size. If the maximumSize property has been explicitly set, it is returned. If the maximumSize property has not been set but the ui property has been, the result of ComponentUI.getMaximumSize(JComponent) is returned. If neither property has been set, the result of Container.getMaximumSize() is returned.
Overrides:
getMaximumSize in interface Container
Returns:
the maximum size of the component
See Also:
Component.setMaximumSize(Dimension), Component.getMaximumSize(), Component.isMaximumSizeSet(), ComponentUI.getMaximumSize(JComponent)

getMinimumSize

public Dimension getMinimumSize()

Get the component's minimum size. If the minimumSize property has been explicitly set, it is returned. If the minimumSize property has not been set but the ui property has been, the result of ComponentUI.getMinimumSize(JComponent) is returned. If neither property has been set, the result of Container.getMinimumSize() is returned.
Overrides:
getMinimumSize in interface Container
Returns:
The minimum size of the component
See Also:
Component.setMinimumSize(Dimension), Component.getMinimumSize(), Component.isMinimumSizeSet(), ComponentUI.getMinimumSize(JComponent)

getNextFocusableComponent

public Component getNextFocusableComponent()

Deprecated. See FocusTraversalPolicy
Return the value of the nextFocusableComponent property.
Returns:
The current value of the property, or null if none has been set.

getPreferredSize

public Dimension getPreferredSize()

Get the component's preferred size. If the preferredSize property has been explicitly set, it is returned. If the preferredSize property has not been set but the ui property has been, the result of ComponentUI.getPreferredSize(JComponent) is returned. If neither property has been set, the result of Container.getPreferredSize() is returned.
Overrides:
getPreferredSize in interface Container
Returns:
The preferred size of the component
See Also:
Component.setPreferredSize(Dimension), Component.getPreferredSize(), Component.isPreferredSizeSet(), ComponentUI.getPreferredSize(JComponent)

getRegisteredKeyStrokes

public KeyStroke[] getRegisteredKeyStrokes()

Return the set of KeyStroke objects which are registered to initiate actions on this component.
Returns:
An array of the registered keystrokes (possibly empty but never null).

getRootPane

public JRootPane getRootPane()

Returns the first ancestor of this component which is a JRootPane. Equivalent to calling SwingUtilities.getRootPane(this);.
Returns:
An ancestral JRootPane, or null if none exists.

getSize

public Dimension getSize(Dimension rv)

Get the component's size. The passed-in Dimension value will be used as the return value, if possible.
Overrides:
getSize in interface Component
Parameters:
rv - Return value object to reuse, if possible
Returns:
The component's current size

getToolTipLocation

public Point getToolTipLocation(MouseEvent event)

Return the location at which the toolTipText property should be displayed, when triggered by a particular mouse event.
Parameters:
event - The event the tooltip is being presented in response to
Returns:
The point at which to display a tooltip, or null if swing is to choose a default location.

getToolTipText

public String getToolTipText()

Returns the current tooltip text for this component, or null if none has been set.
Returns:
the current tooltip text for this component, or null if none has been set
See Also:
setToolTipText(String), getToolTipText(MouseEvent)

getToolTipText

public String getToolTipText(MouseEvent event)

Returns the tooltip text for this component for a particular mouse event. This can be used to support context sensitive tooltips that can change with the mouse location. By default this returns the static tooltip text returned by getToolTipText().
Parameters:
event - the mouse event which triggered the tooltip
Returns:
the tooltip text for this component for a particular mouse event
See Also:
setToolTipText(String), getToolTipText()

getTopLevelAncestor

public Container getTopLevelAncestor()

Return the top level ancestral container (usually a Window or Applet) which this component is contained within, or null if no ancestors exist.
Returns:
The top level container, if it exists

getTransferHandler

public TransferHandler getTransferHandler()

Get the value of the transferHandler property.
Returns:
The current value of the property
See Also:
setTransferHandler(TransferHandler)

getUIClassID

public String getUIClassID()

Get the value of the UIClassID property. This property should be a key in the UIDefaults table managed by UIManager, the value of which is the name of a class to load for the component's ui property.
Returns:
A "symbolic" name which will map to a class to use for the component's UI, such as "ComponentUI"
See Also:
setUI(ComponentUI), updateUI()

getVerifyInputWhenFocusTarget

public boolean getVerifyInputWhenFocusTarget()

Since:
1.3

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners()

Return all registered VetoableChangeListener objects.
Returns:
An array of the VetoableChangeListener objects registered with this component (possibly empty but never null).
Since:
1.4

getVisibleRect

public Rectangle getVisibleRect()

Return the component's visible rectangle in a new Rectangle, rather than via a return slot.
Returns:
the component's visible rectangle
See Also:
computeVisibleRect(Rectangle)

getWidth

public int getWidth()

Returns the width of this component. Prefer this method over getBounds(Rectangle) or getSize(Dimension) because it does not cause any heap allocation.
Overrides:
getWidth in interface Component
Returns:
the width of the component

getX

public int getX()

Returns the X coordinate of the upper left corner of this component. Prefer this method over getBounds(Rectangle) or getLocation(Point) because it does not cause any heap allocation.
Overrides:
getX in interface Component
Returns:
the X coordinate of the upper left corner of the component

getY

public int getY()

Returns the Y coordinate of the upper left corner of this component. Prefer this method over getBounds(Rectangle) or getLocation(Point) because it does not cause any heap allocation.
Overrides:
getY in interface Component
Returns:
the Y coordinate of the upper left corner of the component

grabFocus

public void grabFocus()

Requests that this component receive input focus, giving window focus to the top level ancestor of this component. Only works on displayable, focusable, visible components.
This method should not be called by clients; it is intended for focus implementations. Use Component.requestFocus() instead.
See Also:
Component.requestFocus()

isDoubleBuffered

public boolean isDoubleBuffered()

Get the value of the doubleBuffered property.
Overrides:
isDoubleBuffered in interface Component
Returns:
The property's current value

isLightweightComponent

public static boolean isLightweightComponent(Component c)

Return true if the provided component has no native peer; in other words, if it is a "lightweight component".
Parameters:
c - The component to test for lightweight-ness
Returns:
Whether or not the component is lightweight

isManagingFocus

public boolean isManagingFocus()

Deprecated. 1.4 Use Component.setFocusTraversalKeys(int, Set) and Container.setFocusCycleRoot(boolean) instead
Return true if you wish this component to manage its own focus. In particular: if you want this component to be sent TAB and SHIFT+TAB key events, and to not have its children considered as focus transfer targets. If true, focus traversal around this component changes to CTRL+TAB and CTRL+SHIFT+TAB.
Returns:
true if you want this component to manage its own focus, otherwise (by default) false

isOpaque

public boolean isOpaque()

Return the current value of the opaque property.
Overrides:
isOpaque in interface Component
Returns:
The current property value

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

Return true if the component can guarantee that none of its children will overlap in Z-order. This is a hint to the painting system. The default is to return true, but some components such as JLayeredPane should override this to return false.
Returns:
Whether the component tiles its children

isPaintingTile

public boolean isPaintingTile()

Return true if this component is currently painting a tile, this means that paint() is called again on another child component. This method returns false if this component does not paint a tile or if the last tile is currently painted.
Returns:
whether the component is painting a tile

isRequestFocusEnabled

public boolean isRequestFocusEnabled()

Get the value of the requestFocusEnabled property.
Returns:
The current value of the property

isValidateRoot

public boolean isValidateRoot()

Return true if this component is a validation root; this will cause calls to invalidate() in this component's children to be "captured" at this component, and not propagate to its parents. For most components this should return false, but some components such as JViewport will want to return true.
Returns:
Whether this component is a validation root

paint

public void paint(Graphics g)

Paint the component. This is a delicate process, and should only be called from the repaint thread, under control of the RepaintManager. Client code should usually call repaint() to trigger painting.
The body of the paint call involves calling paintComponent(Graphics), paintBorder(Graphics), and paintChildren(Graphics) in order. If you want to customize painting behavior, you should override one of these methods rather than paint.
For more details on the painting sequence, see this article.
Overrides:
paint in interface Container
Parameters:
g - The graphics context to paint with
See Also:
paintImmediately(Rectangle)

paintBorder

protected void paintBorder(Graphics g)

Paint the component's border. This usually means calling Border.paintBorder(Component,Graphics,int,int,int,int) on the border property, if it is non-null. You may override this if you wish to customize border painting behavior. The border is painted after the component's body, but before the component's children.
Parameters:
g - The graphics context with which to paint the border
See Also:
paint(Graphics), paintChildren(Graphics), paintComponent(Graphics)

paintChildren

protected void paintChildren(Graphics g)

Paint the component's children. This usually means calling Container.paint(Graphics), which recursively calls paint(Graphics) on any of the component's children, with appropriate changes to coordinate space and clipping region. You may override this if you wish to customize children painting behavior. The children are painted after the component's body and border.
Parameters:
g - The graphics context with which to paint the children
See Also:
paint(Graphics), paintBorder(Graphics), paintComponent(Graphics)

paintComponent

protected void paintComponent(Graphics g)

Paint the component's body. This usually means calling ComponentUI.update(Graphics,JComponent) on the ui property of the component, if it is non-null. You may override this if you wish to customize the component's body-painting behavior. The component's body is painted first, before the border and children.
Parameters:
g - The graphics context with which to paint the body
See Also:
paint(Graphics), paintBorder(Graphics), paintChildren(Graphics)

paintImmediately

public void paintImmediately(int x,
                             int y,
                             int w,
                             int h)

A variant of paintImmediately(Rectangle) which takes integer parameters.
Parameters:
x - The left x coordinate of the dirty region
y - The top y coordinate of the dirty region
w - The width of the dirty region
h - The height of the dirty region

paintImmediately

public void paintImmediately(Rectangle r)

Transform the provided dirty rectangle for this component into the appropriate ancestral JRootPane and call paint(Graphics) on that root pane. This method is called from the RepaintManager and should always be called within the painting thread.
This method will acquire a double buffer from the RepaintManager if the component's doubleBuffered property is true and the paint call is the first recursive paint call inside swing.
The method will also modify the provided Graphics context via the getComponentGraphics(Graphics) method. If you want to customize the graphics object used for painting, you should override that method rather than paint.
Parameters:
r - The dirty rectangle to paint

paramString

protected String paramString()

Return a string representation for this component, for use in debugging.
Overrides:
paramString in interface Container
Returns:
A string describing this component.

print

public void print(Graphics g)

Prints this component to the given Graphics context. A call to this method results in calls to the methods printComponent(Graphics), printBorder(Graphics) and printChildren(Graphics) in this order. Double buffering is temporarily turned off so the painting goes directly to the supplied Graphics context.
Overrides:
print in interface Container
Parameters:
g - the Graphics context to print onto

printAll

public void printAll(Graphics g)

Prints this component to the given Graphics context. This invokes print(Graphics).
Overrides:
printAll in interface Component
Parameters:
g - the Graphics context to print onto

printBorder

protected void printBorder(Graphics g)

Print this component's border to the specified Graphics context. The default behaviour is to invoke paintBorder(Graphics). Override this if you want special behaviour for printing.
Parameters:
g - the Graphics context to print onto
Since:
1.3

printChildren

protected void printChildren(Graphics g)

Print this component's children to the specified Graphics context. The default behaviour is to invoke paintChildren(Graphics). Override this if you want special behaviour for printing.
Parameters:
g - the Graphics context to print onto
Since:
1.3

printComponent

protected void printComponent(Graphics g)

Prints this component to the specified Graphics context. The default behaviour is to invoke paintComponent(Graphics). Override this if you want special behaviour for printing.
Parameters:
g - the Graphics context to print onto
Since:
1.3

processComponentKeyEvent

protected void processComponentKeyEvent(KeyEvent e)

A hook for subclasses which want to customize event processing.

processKeyBinding

protected boolean processKeyBinding(KeyStroke ks,
                                    KeyEvent e,
                                    int condition,
                                    boolean pressed)

processKeyEvent

protected void processKeyEvent(KeyEvent e)

Override the default key dispatch system from Component to hook into the swing InputMap / ActionMap system. See this report for more details, it's somewhat complex.
Overrides:
processKeyEvent in interface Component

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent ev)

Processes mouse motion event, like dragging and moving.
Overrides:
processMouseMotionEvent in interface Component
Parameters:
ev - the MouseEvent describing the mouse motion

putClientProperty

public final void putClientProperty(Object key,
                                    Object value)

Add a client property value to this component, associated with key. If there is an existing client property associated with key, it will be replaced. A PropertyChangeEvent is sent to registered listeners (with the name of the property being key.toString()).
Parameters:
key - The key of the client property association to add
value - The value of the client property association to add
See Also:
clientProperties, JComponent, getClientProperty(Object)

registerKeyboardAction

public void registerKeyboardAction(ActionListener act,
                                   String cmd,
                                   KeyStroke stroke,
                                   int cond)

An obsolete method to register a keyboard action on this component. You should use getInputMap and getActionMap to fetch mapping tables from keystrokes to commands, and commands to actions, respectively, and modify those mappings directly.
Parameters:
act - The action to be registered
cmd - The command to deliver in the delivered ActionEvent
stroke - The keystroke to register on
cond - One of the values UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, or WHEN_IN_FOCUSED_WINDOW, indicating the condition which must be met for the action to be fired
See Also:
unregisterKeyboardAction(KeyStroke), getConditionForKeyStroke(KeyStroke), resetKeyboardActions()

registerKeyboardAction

public void registerKeyboardAction(ActionListener act,
                                   KeyStroke stroke,
                                   int cond)

A variant of registerKeyboardAction(ActionListener,String,KeyStroke,int) which provides null for the command name.
Parameters:
act - the action listener to notify when the keystroke occurs.
stroke - the key stroke.
cond - the condition (one of WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW and WHEN_ANCESTOR_OF_FOCUSED_COMPONENT).

removeAncestorListener

public void removeAncestorListener(AncestorListener listener)

Unregister an AncestorListener.
Parameters:
listener - The listener to unregister
See Also:
addAncestorListener(AncestorListener)

removeNotify

public void removeNotify()

Receives notification that this component no longer has a parent. This method sends an AncestorEvent to all registered AncestorListeners, notifying them that the parent is gone. The keybord actions of this component are removed from the parent and its ancestors. A PropertyChangeEvent is fired to indicate that the 'ancestor' property has changed. This method is called before the component is actually removed from its parent, so the parent is still visible through Component.getParent().
Overrides:
removeNotify in interface Container

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

Unregister a VetoableChangeChangeListener.
Parameters:
listener - The listener to unregister
See Also:
addVetoableChangeListener(VetoableChangeListener)

repaint

public void repaint(Rectangle r)

Mark the described region of this component as dirty in the current RepaintManager. This will queue an asynchronous repaint using the system painting thread in the near future.
Parameters:
r - The rectangle to mark as dirty

repaint

public void repaint(long tm,
                    int x,
                    int y,
                    int width,
                    int height)

Mark the described region of this component as dirty in the current RepaintManager. This will queue an asynchronous repaint using the system painting thread in the near future.
Overrides:
repaint in interface Component
Parameters:
tm - ignored
x - coordinate of the region to mark as dirty
y - coordinate of the region to mark as dirty
width - dimension of the region to mark as dirty
height - dimension of the region to mark as dirty

requestDefaultFocus

public boolean requestDefaultFocus()

Deprecated. Use requestFocus() on the default component provided from the FocusTraversalPolicy instead.
Request focus on the default component of this component's FocusTraversalPolicy.
Returns:
The result of requestFocus()

requestFocus

public void requestFocus()

Requests that this component gets the input focus if the requestFocusEnabled property is set to true. This also means that this component's top-level window becomes the focused window, if that is not already the case. The preconditions that have to be met to become a focus owner is that the component must be displayable, visible and focusable. Note that this signals only a request for becoming focused. There are situations in which it is not possible to get the focus. So developers should not assume that the component has the focus until it receives a FocusEvent with a value of FocusEvent.FOCUS_GAINED.
Overrides:
requestFocus in interface Component
See Also:
Component.requestFocus()

requestFocus

public boolean requestFocus(boolean temporary)

This method is overridden to make it public so that it can be used by look and feel implementations. You should not use this method directly. Instead you are strongly encouraged to call requestFocus() or requestFocusInWindow() instead.
Overrides:
requestFocus in interface Component
Parameters:
temporary - if the focus change is temporary
Returns:
false if the focus change request will definitly fail, true if it will likely succeed
Since:
1.4
See Also:
Component.requestFocus(boolean)

requestFocusInWindow

public boolean requestFocusInWindow()

Requests that this component gets the input focus if the top level window that contains this component has the focus and the requestFocusEnabled property is set to true. The preconditions that have to be met to become a focus owner is that the component must be displayable, visible and focusable. Note that this signals only a request for becoming focused. There are situations in which it is not possible to get the focus. So developers should not assume that the component has the focus until it receives a FocusEvent with a value of FocusEvent.FOCUS_GAINED.
Overrides:
requestFocusInWindow in interface Component
Returns:
false if the focus change request will definitly fail, true if it will likely succeed
See Also:
Component.requestFocusInWindow()

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

This method is overridden to make it public so that it can be used by look and feel implementations. You should not use this method directly. Instead you are strongly encouraged to call requestFocus() or requestFocusInWindow() instead.
Overrides:
requestFocusInWindow in interface Component
Parameters:
temporary - if the focus change is temporary
Returns:
false if the focus change request will definitly fail, true if it will likely succeed
Since:
1.4
See Also:
Component.requestFocus(boolean)

resetKeyboardActions

public void resetKeyboardActions()

Reset all keyboard action registries.
See Also:
registerKeyboardAction(ActionListener,KeyStroke,int), unregisterKeyboardAction(KeyStroke), getConditionForKeyStroke(KeyStroke)

reshape

public void reshape(int x,
                    int y,
                    int w,
                    int h)

Moves and resizes the component.
Overrides:
reshape in interface Component
Parameters:
x - the new horizontal location
y - the new vertial location
w - the new width
h - the new height

revalidate

public void revalidate()

Queue a an invalidation and revalidation of this component, using RepaintManager.addInvalidComponent(JComponent).

scrollRectToVisible

public void scrollRectToVisible(Rectangle r)

Calls scrollRectToVisible on the component's parent. Components which can service this call should override.
Parameters:
r - The rectangle to make visible

setActionMap

public final void setActionMap(ActionMap map)

setAlignmentX

public void setAlignmentX(float a)

Set the value of the alignmentX property.
Parameters:
a - The new value of the property

setAlignmentY

public void setAlignmentY(float a)

Set the value of the alignmentY property.
Parameters:
a - The new value of the property

setAutoscrolls

public void setAutoscrolls(boolean a)

Set the value of the autoscrolls property.
Parameters:
a - The new value of the property

setBackground

public void setBackground(Color bg)

Set the value of the background property.
Overrides:
setBackground in interface Component
Parameters:
bg - The new value of the property

setBorder

public void setBorder(Border newBorder)

Set the value of the border property.
Parameters:
newBorder - The new value of the property
See Also:
getBorder()

setComponentPopupMenu

public void setComponentPopupMenu(JPopupMenu popup)

Sets the popup menu for this component (this is a bound property with the property name 'componentPopupMenu').
Parameters:
popup - the popup menu (null permitted).
Since:
1.5
See Also:
getComponentPopupMenu()

setDebugGraphicsOptions

public void setDebugGraphicsOptions(int debugOptions)

Set the value of the debugGraphicsOptions property.
Parameters:
debugOptions - The new value of the property

setDefaultLocale

public static void setDefaultLocale(Locale l)

Sets the locale to be used as the default for all new components. If this is set to null, the getDefaultLocale() method will return the platform default locale.
Parameters:
l - the locale (null permitted).

setDoubleBuffered

public void setDoubleBuffered(boolean db)

Set the value of the doubleBuffered property.
Parameters:
db - The new value of the property

setEnabled

public void setEnabled(boolean enable)

Set the value of the enabled property.
Overrides:
setEnabled in interface Component
Parameters:
enable - The new value of the property

setFont

public void setFont(Font f)

Set the value of the font property.
Overrides:
setFont in interface Container
Parameters:
f - The new value of the property

setForeground

public void setForeground(Color fg)

Set the value of the foreground property.
Overrides:
setForeground in interface Component
Parameters:
fg - The new value of the property

setInheritsPopupMenu

public void setInheritsPopupMenu(boolean inherit)

Sets the flag that controls whether or not the component inherits its parent's popup menu when no popup menu is specified for this component. This is a bound property with the property name 'inheritsPopupMenu'.
Parameters:
inherit - the new flag value.
Since:
1.5
See Also:
getInheritsPopupMenu()

setInputMap

public final void setInputMap(int condition,
                              InputMap map)

Sets the input map for the given condition.
Parameters:
condition - the condition (one of WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW and WHEN_ANCESTOR_OF_FOCUSED_COMPONENT).
map - the map.
Throws:
IllegalArgumentException - if condition is not one of the specified values.

setInputVerifier

public void setInputVerifier(InputVerifier verifier)

Sets the input verifier to use by this component.
Parameters:
verifier - the input verifier, or null

setNextFocusableComponent

public void setNextFocusableComponent(Component aComponent)

Deprecated. Use FocusTraversalPolicy instead
Set the specified component to be the next component in the focus cycle, overriding the FocusTraversalPolicy for this component.
Parameters:
aComponent - The component to set as the next focusable

setOpaque

public void setOpaque(boolean isOpaque)

Set if the component should paint all pixels withing its bounds. If this property is set to false, the component expects the cleared background.
Parameters:
isOpaque - if true, paint all pixels. If false, expect the clean background.
See Also:
ComponentUI.update(Graphics,JComponent)

setRequestFocusEnabled

public void setRequestFocusEnabled(boolean e)

Set the value of the requestFocusEnabled property.
Parameters:
e - The new value of the property

setToolTipText

public void setToolTipText(String text)

Set the tooltip text for this component. If a non-null value is set, this component is registered in the ToolTipManager in order to turn on tooltips for this component. If a null value is set, tooltips are turne off for this component.
Parameters:
text - the tooltip text for this component
See Also:
getToolTipText(), getToolTipText(MouseEvent)

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

Set the value of the transferHandler property.
Parameters:
newHandler - The new value of the property
See Also:
getTransferHandler()

setUI

protected void setUI(ComponentUI newUI)

Install a new UI delegate as the component's ui property. In the process, this will call ComponentUI.uninstallUI(JComponent) on any existing value for the ui property, and ComponentUI.installUI(JComponent) on the new UI delegate.
Parameters:
newUI - The new UI delegate to install
See Also:
updateUI(), getUIClassID()

setVerifyInputWhenFocusTarget

public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)

Since:
1.3

setVisible

public void setVisible(boolean v)

Set the value of the visible property. If the value is changed, then the AncestorListeners of this component and all its children (recursivly) are notified.
Overrides:
setVisible in interface Component
Parameters:
v - The new value of the property

unregisterKeyboardAction

public void unregisterKeyboardAction(KeyStroke aKeyStroke)

Remove a keyboard action registry.
Parameters:
aKeyStroke - The keystroke to unregister
See Also:
registerKeyboardAction(ActionListener,KeyStroke,int), getConditionForKeyStroke(KeyStroke), resetKeyboardActions()

update

public void update(Graphics g)

Call paint(Graphics).
Overrides:
update in interface Container
Parameters:
g - The graphics context to paint into

updateUI

public void updateUI()

This method should be overridden in subclasses. In JComponent, the method does nothing. In subclasses, it should a UI delegate (corresponding to the symbolic name returned from getUIClassID()) from the UIManager, and calls setUI(ComponentUI) with the new delegate.

JComponent.java -- Every component in swing inherits from this class. Copyright (C) 2002, 2004, 2005, 2006, Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.

Overview Package Class Use Source Tree Index Deprecated About	GNU Classpath (0.95)
Prev Class \| Next Class	GNU Classpath (0.95)	Frames \| No Frames
Summary: Nested \| Field \| Method \| Constr	Detail: Nested \| Field \| Method \| Constr

javax.swing

Class JComponent

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Details

TOOL_TIP_TEXT_KEY

UNDEFINED_CONDITION

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

WHEN_FOCUSED

WHEN_IN_FOCUSED_WINDOW

accessibleContext

listenerList

ui

Constructor Details

JComponent

Method Details

addAncestorListener

addNotify

addVetoableChangeListener

computeVisibleRect

contains

createToolTip

disable

enable

extends EventListener> T[] getListeners

firePropertyChange

firePropertyChange

fireVetoableChange

getAccessibleContext

getActionForKeyStroke

getActionMap

getAlignmentX

getAlignmentY

getAncestorListeners

getAutoscrolls

getBorder

getBounds

getClientProperty

getComponentGraphics

getComponentPopupMenu

getConditionForKeyStroke

getDebugGraphicsOptions

getDefaultLocale

getGraphics

getHeight

getInheritsPopupMenu

getInputMap

getInputMap

getInputVerifier

getInsets

getInsets

getLocation

getMaximumSize

getMinimumSize

getNextFocusableComponent

getPreferredSize

getRegisteredKeyStrokes

getRootPane

getSize

getToolTipLocation

getToolTipText

getToolTipText

getTopLevelAncestor

getTransferHandler

getUIClassID

getVerifyInputWhenFocusTarget

getVetoableChangeListeners

getVisibleRect

getWidth

getX

getY