JComponent

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> javax >> [ swing overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.swing
Class JComponent

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

All Implemented Interfaces:: java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

Direct Known Subclasses:: AbstractButton, 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, javax.swing.text.JTextComponent, JToolBar, JToolTip, JTree, JViewport

public abstract class JComponent
extends java.awt.Container
implements java.io.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.

Nested Class Summary

class JComponent.AccessibleJComponent
          Basic accessibility support for JComponent derived widgets.

private static class JComponent.ActionListenerProxy


Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

protected javax.accessibility.AccessibleContext accessibleContext
          The accessible context of this JComponent.

private ActionMap actionMap


(package private) float alignmentX
          A value between 0.0 and 1.0 indicating the preferred horizontal alignment of the component, relative to its siblings.

(package private) float alignmentY
          A value between 0.0 and 1.0 indicating the preferred vertical alignment of the component, relative to its siblings.

(package private) boolean autoscrolls
          Flag indicating behavior of this component when the mouse is dragged outside the component and the mouse stops moving.

(package private) javax.swing.border.Border border
          The border painted around this component.

private boolean clientAutoscrollsSet
          Indicates if the autoscrolls property has been set by a client program or by the UI.

private boolean clientOpaqueSet
          Indicates if the opaque property has been set by a client program or by the UI.

private java.util.Hashtable clientProperties
          Storage for "client properties", which are key/value pairs associated with this component by a "client", such as a user application or a layout manager.

(package private) int debugGraphicsOptions
          A set of flags indicating which debugging graphics facilities should be enabled on this component.

private static java.util.Locale defaultLocale
          The default locale of the component.

(package private) boolean doubleBuffered
          Whether to double buffer this component when painting.

private java.awt.Image dragBuffer
          A temporary buffer used for fast dragging of components.

private boolean dragBufferInitialized
          Indicates if the dragBuffer is already initialized.

private InputMap inputMap_whenAncestorOfFocused


private InputMap inputMap_whenFocused


private ComponentInputMap inputMap_whenInFocusedWindow


private InputVerifier inputVerifier


(package private) boolean isCompletelyDirty
          Indicates if this component is completely dirty or not.

(package private) static boolean isPaintingDoubleBuffered
          Indicates whether the current paint call is already double buffered or not.

protected javax.swing.event.EventListenerList listenerList
          Listeners for events other than java.beans.PropertyChangeEvent are handled by this listener list.

(package private) java.awt.Dimension maximumSize
          An explicit value for the component's maximum size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getMaximumSize(javax.swing.JComponent)>ComponentUI.getMaximumSize(javax.swing.JComponent) 55 method on the ui 55 property.

(package private) java.awt.Dimension minimumSize
          An explicit value for the component's minimum size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getMinimumSize(javax.swing.JComponent)>ComponentUI.getMinimumSize(javax.swing.JComponent) 55 method on the ui 55 property.

(package private) boolean opaque
          This property controls two independent behaviors simultaneously.

private boolean paintingTile
          Indicates if this component is currently painting a tile or not.

(package private) java.awt.Dimension preferredSize
          An explicit value for the component's preferred size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getPreferredSize(javax.swing.JComponent)>ComponentUI.getPreferredSize(javax.swing.JComponent) 55 method on the ui 55 property.

private static java.awt.Rectangle rectCache
          A cached Rectangle object to be reused.

(package private) boolean requestFocusEnabled
          A hint to the focus system that this component should or should not get focus.

private static long serialVersionUID


static java.lang.String TOOL_TIP_TEXT_KEY


(package private) java.lang.String toolTipText
          The text to show in the tooltip associated with this component.

private TransferHandler transferHandler


protected javax.swing.plaf.ComponentUI ui
          The user interface delegate for this component.

static int UNDEFINED_CONDITION
          Constant used to indicate that no condition has been assigned to a particular action.

private boolean verifyInputWhenFocusTarget


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.

Fields inherited from class java.awt.Container

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(javax.swing.event.AncestorListener listener)
          Register an AncestorListener.

void addNotify()
          Receives notification if this component is added to a parent component.

void addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
          Register a PropertyChangeListener for a specific, named property.

void addVetoableChangeListener(java.beans.VetoableChangeListener listener)
          Register a VetoableChangeListener.

void computeVisibleRect(java.awt.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) 55

void enable()
          Deprecated. replaced by setEnabled(boolean) 55

private java.awt.Component findOpaqueParent(java.awt.Component c)
          Finds the nearest component to c (upwards in the containment hierarchy), that is opaque.

private java.awt.Component findOverlapFreeParent(java.awt.Rectangle clip)
          Scans the containment hierarchy upwards for components that overlap the this component in the specified clip.

private java.awt.Component findPaintRoot(java.awt.Rectangle c)
          Finds a suitable paint root for painting this component.

(package private) void fireAncestorEvent(JComponent ancestor, int id)
          Fires an AncestorEvent to this component's and all of its child component's AncestorListeners.

void firePropertyChange(java.lang.String propertyName, boolean oldValue, boolean newValue)
          A variant of Component.firePropertyChange(String,Object,Object)>Component.firePropertyChange(String,Object,Object) 55 for properties with boolean values.

void firePropertyChange(java.lang.String propertyName, char oldValue, char newValue)
          A variant of Component.firePropertyChange(String,Object,Object)>Component.firePropertyChange(String,Object,Object) 55 for properties with char values.

void firePropertyChange(java.lang.String propertyName, int oldValue, int newValue)
          A variant of Component.firePropertyChange(String,Object,Object)>Component.firePropertyChange(String,Object,Object) 55 for properties with int values.

protected void fireVetoableChange(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue)
          Call VetoableChangeListener.vetoableChange(java.beans.PropertyChangeEvent)>VetoableChangeListener.vetoableChange(java.beans.PropertyChangeEvent) 55 on all listeners registered to listen to a given property.

javax.accessibility.AccessibleContext getAccessibleContext()
          Get the value of the accessibleContext property for this component.

java.awt.event.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 55 property.

float getAlignmentY()
          Get the value of the alignmentY 55 property.

javax.swing.event.AncestorListener[] getAncestorListeners()
          Return all registered AncestorListener objects.

boolean getAutoscrolls()
          Get the current value of the autoscrolls 55 property.

javax.swing.border.Border getBorder()
          Get the value of the border 55 property.

java.awt.Rectangle getBounds(java.awt.Rectangle rv)
          Get the component's current bounding box.

private java.util.Hashtable getClientProperties()
          Helper to lazily construct and return the client properties table.

java.lang.Object getClientProperty(java.lang.Object key)
          Get a client property associated with this component and a particular key.

protected java.awt.Graphics getComponentGraphics(java.awt.Graphics g)
          Prepares a graphics context for painting this object.

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 55 property.

static java.util.Locale getDefaultLocale()


java.awt.Graphics getGraphics()
          Returns the Graphics context for this component.

int getHeight()
          Returns the height of this component.

InputMap getInputMap()


InputMap getInputMap(int condition)


InputVerifier getInputVerifier()
          Returns the currently set input verifier for this component.

java.awt.Insets getInsets()
          Get the component's insets, which are calculated from the border 55 property.

java.awt.Insets getInsets(java.awt.Insets insets)
          Get the component's insets, which are calculated from the border 55 property.

java.util.EventListener[] getListeners(java.lang.Class listenerType)
          Returns all registered java.util.EventListeners of the given listenerType.

java.awt.Point getLocation(java.awt.Point rv)
          Get the component's location.

java.awt.Dimension getMaximumSize()
          Get the component's maximum size.

java.awt.Dimension getMinimumSize()
          Get the component's minimum size.

java.awt.Component getNextFocusableComponent()
          Deprecated. See java.awt.FocusTraversalPolicy

java.awt.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.

private java.awt.Component getRoot(java.awt.Component comp)
          Gets the root of the component given.

JRootPane getRootPane()
          Returns the first ancestor of this component which is a JRootPane.

java.awt.Dimension getSize(java.awt.Dimension rv)
          Get the component's size.

java.awt.Point getToolTipLocation(java.awt.event.MouseEvent event)
          Return the location at which the toolTipText 55 property should be displayed, when triggered by a particular mouse event.

java.lang.String getToolTipText()
          Get the value of the toolTipText 55 property.

java.lang.String getToolTipText(java.awt.event.MouseEvent event)
          Get the value of the toolTipText 55 property, in response to a particular mouse event.

java.awt.Container getTopLevelAncestor()
          Return the top level ancestral container (usually a java.awt.Window or java.applet.Applet) which this component is contained within, or null if no ancestors exist.

TransferHandler getTransferHandler()
          Get the value of the transferHandler 55 property.

java.lang.String getUIClassID()
          Get the value of the UIClassID property.

boolean getVerifyInputWhenFocusTarget()


java.beans.VetoableChangeListener[] getVetoableChangeListeners()
          Return all registered VetoableChangeListener objects.

java.awt.Rectangle getVisibleRect()
          Return the component's visible rectangle in a new java.awt.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.

private void initializeDragBuffer()
          Initializes the drag buffer by creating a new image and painting this component into it.

boolean isDoubleBuffered()
          Get the value of the doubleBuffered 55 property.

static boolean isLightweightComponent(java.awt.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)>Component.setFocusTraversalKeys(int, Set) 55 and Container.setFocusCycleRoot(boolean)>Container.setFocusCycleRoot(boolean) 55 instead

boolean isMaximumSizeSet()
          Checks if a maximum size was explicitely set on the component.

boolean isMinimumSizeSet()
          Checks if a minimum size was explicitely set on the component.

boolean isOpaque()
          Return the current value of the opaque 55 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 isPreferredSizeSet()
          Checks if a preferred size was explicitely set on the component.

boolean isRequestFocusEnabled()
          Get the value of the requestFocusEnabled 55 property.

boolean isValidateRoot()
          Return true if this component is a validation root; this will cause calls to Container.invalidate()>Container.invalidate() 55 in this component's children to be "captured" at this component, and not propagate to its parents.

void paint(java.awt.Graphics g)
          Paint the component.

protected void paintBorder(java.awt.Graphics g)
          Paint the component's border.

protected void paintChildren(java.awt.Graphics g)
          Paint the component's children.

private void paintChildrenOptimized(java.awt.Graphics g)
          Paints the children of this container when it is marked as optimizedDrawingEnabled.

private void paintChildrenWithOverlap(java.awt.Graphics g)
          Paints the children of this JComponent in the case when the component is not marked as optimizedDrawingEnabled, that means the container cannot guarantee that it's children are tiled.

protected void paintComponent(java.awt.Graphics g)
          Paint the component's body.

private void paintDoubleBuffered(java.awt.Rectangle r)
          Performs double buffered repainting.

void paintImmediately(int x, int y, int w, int h)
          A variant of paintImmediately(Rectangle) 55 which takes integer parameters.

void paintImmediately(java.awt.Rectangle r)
          Transform the provided dirty rectangle for this component into the appropriate ancestral JRootPane and call paint(java.awt.Graphics) 55 on that root pane.

(package private) void paintImmediately2(java.awt.Rectangle r)
          Performs the actual work of paintImmediatly on the repaint root.

(package private) void paintSimple(java.awt.Rectangle r)
          Performs normal painting without double buffering.

protected java.lang.String paramString()
          Return a string representation for this component, for use in debugging.

void print(java.awt.Graphics g)
          Prints this component to the given Graphics context.

void printAll(java.awt.Graphics g)
          Prints this component to the given Graphics context.

protected void printBorder(java.awt.Graphics g)
          Print this component's border to the specified Graphics context.

protected void printChildren(java.awt.Graphics g)
          Print this component's children to the specified Graphics context.

protected void printComponent(java.awt.Graphics g)
          Prints this component to the specified Graphics context.

protected void processComponentKeyEvent(java.awt.event.KeyEvent e)
          A hook for subclasses which want to customize event processing.

protected boolean processKeyBinding(KeyStroke ks, java.awt.event.KeyEvent e, int condition, boolean pressed)


protected void processKeyEvent(java.awt.event.KeyEvent e)
          Override the default key dispatch system from Component to hook into the swing InputMap / ActionMap system.

protected void processMouseMotionEvent(java.awt.event.MouseEvent ev)
          Processes mouse motion event, like dragging and moving.

void putClientProperty(java.lang.Object key, java.lang.Object value)
          Add a client property value to this component, associated with key.

void registerKeyboardAction(java.awt.event.ActionListener act, KeyStroke stroke, int cond)
          A variant of registerKeyboardAction(ActionListener,String,KeyStroke,int) 55 which provides null for the command name.

void registerKeyboardAction(java.awt.event.ActionListener act, java.lang.String cmd, KeyStroke stroke, int cond)
          An obsolete method to register a keyboard action on this component.

void removeAncestorListener(javax.swing.event.AncestorListener listener)
          Unregister an AncestorListener.

void removeNotify()
          Receives notification that this component no longer has a parent.

void removeVetoableChangeListener(java.beans.VetoableChangeListener listener)
          Unregister a VetoableChangeChangeListener.

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.

void repaint(java.awt.Rectangle r)
          Mark the described region of this component as dirty in the current RepaintManager.

boolean requestDefaultFocus()
          Deprecated. Use requestFocus() 55 on the default component provided from the java.awt.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(javax.swing.JComponent) 55 .

void scrollRectToVisible(java.awt.Rectangle r)
          Calls scrollRectToVisible on the component's parent.

void setActionMap(ActionMap map)


void setAlignmentX(float a)
          Set the value of the alignmentX 55 property.

void setAlignmentY(float a)
          Set the value of the alignmentY 55 property.

void setAutoscrolls(boolean a)
          Set the value of the autoscrolls 55 property.

void setBackground(java.awt.Color bg)
          Set the value of the background property.

void setBorder(javax.swing.border.Border newBorder)
          Set the value of the border 55 property.

void setDebugGraphicsOptions(int debugOptions)
          Set the value of the debugGraphicsOptions 55 property.

static void setDefaultLocale(java.util.Locale l)


void setDoubleBuffered(boolean db)
          Set the value of the doubleBuffered 55 property.

void setEnabled(boolean enable)
          Set the value of the enabled property.

void setFont(java.awt.Font f)
          Set the value of the font property.

void setForeground(java.awt.Color fg)
          Set the value of the foreground property.

void setInputMap(int condition, InputMap map)


void setInputVerifier(InputVerifier verifier)
          Sets the input verifier to use by this component.

void setMaximumSize(java.awt.Dimension max)
          Set the value of the maximumSize 55 property.

void setMinimumSize(java.awt.Dimension min)
          Set the value of the minimumSize 55 property.

void setNextFocusableComponent(java.awt.Component aComponent)
          Deprecated. Use FocusTraversalPolicy instead

void setOpaque(boolean isOpaque)
          Set if the component should paint all pixels withing its bounds.

void setPreferredSize(java.awt.Dimension pref)
          Set the value of the preferredSize 55 property.

void setRequestFocusEnabled(boolean e)
          Set the value of the requestFocusEnabled 55 property.

void setToolTipText(java.lang.String text)
          Set the value of the toolTipText 55 property.

void setTransferHandler(TransferHandler newHandler)
          Set the value of the transferHandler 55 property.

protected void setUI(javax.swing.plaf.ComponentUI newUI)
          Install a new UI delegate as the component's ui 55 property.

(package private) void setUIProperty(java.lang.String propertyName, java.lang.Object value)
          Helper method for LookAndFeel.installProperty(JComponent, String, Object) 55 .

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(java.awt.Graphics g)
          Call paint(java.awt.Graphics) 55 .

(package private) void updateComponentInputMap(ComponentInputMap changed)
          This is the method that gets called when the WHEN_IN_FOCUSED_WINDOW map is changed.

void updateUI()
          This method should be overridden in subclasses.

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:: Constant Field Values

accessibleContext

protected javax.accessibility.AccessibleContext accessibleContext

The accessible context of this JComponent.

preferredSize

java.awt.Dimension preferredSize

An explicit value for the component's preferred size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getPreferredSize(javax.swing.JComponent)>ComponentUI.getPreferredSize(javax.swing.JComponent) 55 method on the ui 55 property.

minimumSize

java.awt.Dimension minimumSize

An explicit value for the component's minimum size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getMinimumSize(javax.swing.JComponent)>ComponentUI.getMinimumSize(javax.swing.JComponent) 55 method on the ui 55 property.

maximumSize

java.awt.Dimension maximumSize

An explicit value for the component's maximum size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getMaximumSize(javax.swing.JComponent)>ComponentUI.getMaximumSize(javax.swing.JComponent) 55 method on the ui 55 property.

alignmentX

float alignmentX

A value between 0.0 and 1.0 indicating the preferred horizontal alignment of the component, relative to its siblings. The values Component.LEFT_ALIGNMENT>Component.LEFT_ALIGNMENT 55 , Component.CENTER_ALIGNMENT>Component.CENTER_ALIGNMENT 55 , and Component.RIGHT_ALIGNMENT>Component.RIGHT_ALIGNMENT 55 can also be used, as synonyms for 0.0, 0.5, and 1.0, respectively. Not all layout managers use this property.

See Also:: getAlignmentX() 55 , setAlignmentX(float) 55 , OverlayLayout, BoxLayout

alignmentY

float alignmentY

A value between 0.0 and 1.0 indicating the preferred vertical alignment of the component, relative to its siblings. The values Component.TOP_ALIGNMENT>Component.TOP_ALIGNMENT 55 , Component.CENTER_ALIGNMENT>Component.CENTER_ALIGNMENT 55 , and Component.BOTTOM_ALIGNMENT>Component.BOTTOM_ALIGNMENT 55 can also be used, as synonyms for 0.0, 0.5, and 1.0, respectively. Not all layout managers use this property.

See Also:: getAlignmentY() 55 , setAlignmentY(float) 55 , OverlayLayout, BoxLayout

border

javax.swing.border.Border border

The border painted around this component.

See Also:: paintBorder(java.awt.Graphics) 55

toolTipText

java.lang.String toolTipText

The text to show in the tooltip associated with this component.

See Also:: setToolTipText(java.lang.String) 55 , getToolTipText() 55

doubleBuffered

boolean doubleBuffered

Whether to double buffer this component when painting. This flag should generally be true, to ensure good painting performance.

All children of a double buffered component are painted into the double buffer automatically, so only the top widget in a window needs to be double buffered.

See Also:: setDoubleBuffered(boolean) 55 , isDoubleBuffered() 55 , paint(java.awt.Graphics) 55

debugGraphicsOptions

int debugGraphicsOptions

A set of flags indicating which debugging graphics facilities should be enabled on this component. The values should be a combination of DebugGraphics.NONE_OPTION 55 , DebugGraphics.LOG_OPTION 55 , DebugGraphics.FLASH_OPTION 55 , or DebugGraphics.BUFFERED_OPTION 55 .

See Also:: setDebugGraphicsOptions(int) 55 , getDebugGraphicsOptions() 55 , DebugGraphics, getComponentGraphics(java.awt.Graphics) 55

opaque

boolean opaque

This property controls two independent behaviors simultaneously.

First, it controls whether to fill the background of this widget when painting its body. This affects calls to

Nested Class Summary
`class`	`JComponent.AccessibleJComponent` Basic accessibility support for `JComponent` derived widgets.
`private static class`	`JComponent.ActionListenerProxy`

Field Summary
`protected javax.accessibility.AccessibleContext`	`accessibleContext` The accessible context of this `JComponent`.
`private ActionMap`	`actionMap`
`(package private) float`	`alignmentX` A value between 0.0 and 1.0 indicating the preferred horizontal alignment of the component, relative to its siblings.
`(package private) float`	`alignmentY` A value between 0.0 and 1.0 indicating the preferred vertical alignment of the component, relative to its siblings.
`(package private) boolean`	`autoscrolls` Flag indicating behavior of this component when the mouse is dragged outside the component and the mouse stops moving.
`(package private) javax.swing.border.Border`	`border` The border painted around this component.
`private boolean`	`clientAutoscrollsSet` Indicates if the autoscrolls property has been set by a client program or by the UI.
`private boolean`	`clientOpaqueSet` Indicates if the opaque property has been set by a client program or by the UI.
`private java.util.Hashtable`	`clientProperties` Storage for "client properties", which are key/value pairs associated with this component by a "client", such as a user application or a layout manager.
`(package private) int`	`debugGraphicsOptions` A set of flags indicating which debugging graphics facilities should be enabled on this component.
`private static java.util.Locale`	`defaultLocale` The default locale of the component.
`(package private) boolean`	`doubleBuffered` Whether to double buffer this component when painting.
`private java.awt.Image`	`dragBuffer` A temporary buffer used for fast dragging of components.
`private boolean`	`dragBufferInitialized` Indicates if the dragBuffer is already initialized.
`private InputMap`	`inputMap_whenAncestorOfFocused`
`private InputMap`	`inputMap_whenFocused`
`private ComponentInputMap`	`inputMap_whenInFocusedWindow`
`private InputVerifier`	`inputVerifier`
`(package private) boolean`	`isCompletelyDirty` Indicates if this component is completely dirty or not.
`(package private) static boolean`	`isPaintingDoubleBuffered` Indicates whether the current paint call is already double buffered or not.
`protected javax.swing.event.EventListenerList`	`listenerList` Listeners for events other than java.beans.PropertyChangeEvent are handled by this listener list.
`(package private) java.awt.Dimension`	`maximumSize` An explicit value for the component's maximum size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getMaximumSize(javax.swing.JComponent)>`ComponentUI.getMaximumSize(javax.swing.JComponent)` 55 method on the `ui` 55 property.
`(package private) java.awt.Dimension`	`minimumSize` An explicit value for the component's minimum size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getMinimumSize(javax.swing.JComponent)>`ComponentUI.getMinimumSize(javax.swing.JComponent)` 55 method on the `ui` 55 property.
`(package private) boolean`	`opaque` This property controls two independent behaviors simultaneously.
`private boolean`	`paintingTile` Indicates if this component is currently painting a tile or not.
`(package private) java.awt.Dimension`	`preferredSize` An explicit value for the component's preferred size; if not set by a user, this is calculated on the fly by delegating to the ComponentUI.getPreferredSize(javax.swing.JComponent)>`ComponentUI.getPreferredSize(javax.swing.JComponent)` 55 method on the `ui` 55 property.
`private static java.awt.Rectangle`	`rectCache` A cached Rectangle object to be reused.
`(package private) boolean`	`requestFocusEnabled` A hint to the focus system that this component should or should not get focus.
`private static long`	`serialVersionUID`
`static java.lang.String`	`TOOL_TIP_TEXT_KEY`
`(package private) java.lang.String`	`toolTipText` The text to show in the tooltip associated with this component.
`private TransferHandler`	`transferHandler`
`protected javax.swing.plaf.ComponentUI`	`ui` The user interface delegate for this component.
`static int`	`UNDEFINED_CONDITION` Constant used to indicate that no condition has been assigned to a particular action.
`private boolean`	`verifyInputWhenFocusTarget`
`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.

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

Method Summary
`void`	`addAncestorListener(javax.swing.event.AncestorListener listener)` Register an `AncestorListener`.
`void`	`addNotify()` Receives notification if this component is added to a parent component.
`void`	`addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)` Register a `PropertyChangeListener` for a specific, named property.
`void`	`addVetoableChangeListener(java.beans.VetoableChangeListener listener)` Register a `VetoableChangeListener`.
`void`	`computeVisibleRect(java.awt.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)` 55
`void`	`enable()` Deprecated. replaced by `setEnabled(boolean)` 55
`private java.awt.Component`	`findOpaqueParent(java.awt.Component c)` Finds the nearest component to `c` (upwards in the containment hierarchy), that is opaque.
`private java.awt.Component`	`findOverlapFreeParent(java.awt.Rectangle clip)` Scans the containment hierarchy upwards for components that overlap the this component in the specified clip.
`private java.awt.Component`	`findPaintRoot(java.awt.Rectangle c)` Finds a suitable paint root for painting this component.
`(package private) void`	`fireAncestorEvent(JComponent ancestor, int id)` Fires an AncestorEvent to this component's and all of its child component's AncestorListeners.
`void`	`firePropertyChange(java.lang.String propertyName, boolean oldValue, boolean newValue)` A variant of Component.firePropertyChange(String,Object,Object)>`Component.firePropertyChange(String,Object,Object)` 55 for properties with `boolean` values.
`void`	`firePropertyChange(java.lang.String propertyName, char oldValue, char newValue)` A variant of Component.firePropertyChange(String,Object,Object)>`Component.firePropertyChange(String,Object,Object)` 55 for properties with `char` values.
`void`	`firePropertyChange(java.lang.String propertyName, int oldValue, int newValue)` A variant of Component.firePropertyChange(String,Object,Object)>`Component.firePropertyChange(String,Object,Object)` 55 for properties with `int` values.
`protected void`	`fireVetoableChange(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue)` Call VetoableChangeListener.vetoableChange(java.beans.PropertyChangeEvent)>`VetoableChangeListener.vetoableChange(java.beans.PropertyChangeEvent)` 55 on all listeners registered to listen to a given property.
`javax.accessibility.AccessibleContext`	`getAccessibleContext()` Get the value of the accessibleContext property for this component.
`java.awt.event.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` 55 property.
`float`	`getAlignmentY()` Get the value of the `alignmentY` 55 property.
`javax.swing.event.AncestorListener[]`	`getAncestorListeners()` Return all registered `AncestorListener` objects.
`boolean`	`getAutoscrolls()` Get the current value of the `autoscrolls` 55 property.
`javax.swing.border.Border`	`getBorder()` Get the value of the `border` 55 property.
`java.awt.Rectangle`	`getBounds(java.awt.Rectangle rv)` Get the component's current bounding box.
`private java.util.Hashtable`	`getClientProperties()` Helper to lazily construct and return the client properties table.
`java.lang.Object`	`getClientProperty(java.lang.Object key)` Get a client property associated with this component and a particular key.
`protected java.awt.Graphics`	`getComponentGraphics(java.awt.Graphics g)` Prepares a graphics context for painting this object.
`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` 55 property.
`static java.util.Locale`	`getDefaultLocale()`
`java.awt.Graphics`	`getGraphics()` Returns the Graphics context for this component.
`int`	`getHeight()` Returns the height of this component.
`InputMap`	`getInputMap()`
`InputMap`	`getInputMap(int condition)`
`InputVerifier`	`getInputVerifier()` Returns the currently set input verifier for this component.
`java.awt.Insets`	`getInsets()` Get the component's insets, which are calculated from the `border` 55 property.
`java.awt.Insets`	`getInsets(java.awt.Insets insets)` Get the component's insets, which are calculated from the `border` 55 property.
`java.util.EventListener[]`	`getListeners(java.lang.Class listenerType)` Returns all registered java.util.EventListeners of the given `listenerType`.
`java.awt.Point`	`getLocation(java.awt.Point rv)` Get the component's location.
`java.awt.Dimension`	`getMaximumSize()` Get the component's maximum size.
`java.awt.Dimension`	`getMinimumSize()` Get the component's minimum size.
`java.awt.Component`	`getNextFocusableComponent()` Deprecated. See java.awt.FocusTraversalPolicy
`java.awt.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.
`private java.awt.Component`	`getRoot(java.awt.Component comp)` Gets the root of the component given.
`JRootPane`	`getRootPane()` Returns the first ancestor of this component which is a JRootPane.
`java.awt.Dimension`	`getSize(java.awt.Dimension rv)` Get the component's size.
`java.awt.Point`	`getToolTipLocation(java.awt.event.MouseEvent event)` Return the location at which the `toolTipText` 55 property should be displayed, when triggered by a particular mouse event.
`java.lang.String`	`getToolTipText()` Get the value of the `toolTipText` 55 property.
`java.lang.String`	`getToolTipText(java.awt.event.MouseEvent event)` Get the value of the `toolTipText` 55 property, in response to a particular mouse event.
`java.awt.Container`	`getTopLevelAncestor()` Return the top level ancestral container (usually a java.awt.Window or java.applet.Applet) which this component is contained within, or `null` if no ancestors exist.
`TransferHandler`	`getTransferHandler()` Get the value of the `transferHandler` 55 property.
`java.lang.String`	`getUIClassID()` Get the value of the UIClassID property.
`boolean`	`getVerifyInputWhenFocusTarget()`
`java.beans.VetoableChangeListener[]`	`getVetoableChangeListeners()` Return all registered `VetoableChangeListener` objects.
`java.awt.Rectangle`	`getVisibleRect()` Return the component's visible rectangle in a new java.awt.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.
`private void`	`initializeDragBuffer()` Initializes the drag buffer by creating a new image and painting this component into it.
`boolean`	`isDoubleBuffered()` Get the value of the `doubleBuffered` 55 property.
`static boolean`	`isLightweightComponent(java.awt.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)>`Component.setFocusTraversalKeys(int, Set)` 55 and Container.setFocusCycleRoot(boolean)>`Container.setFocusCycleRoot(boolean)` 55 instead
`boolean`	`isMaximumSizeSet()` Checks if a maximum size was explicitely set on the component.
`boolean`	`isMinimumSizeSet()` Checks if a minimum size was explicitely set on the component.
`boolean`	`isOpaque()` Return the current value of the `opaque` 55 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`	`isPreferredSizeSet()` Checks if a preferred size was explicitely set on the component.
`boolean`	`isRequestFocusEnabled()` Get the value of the `requestFocusEnabled` 55 property.
`boolean`	`isValidateRoot()` Return `true` if this component is a validation root; this will cause calls to Container.invalidate()>`Container.invalidate()` 55 in this component's children to be "captured" at this component, and not propagate to its parents.
`void`	`paint(java.awt.Graphics g)` Paint the component.
`protected void`	`paintBorder(java.awt.Graphics g)` Paint the component's border.
`protected void`	`paintChildren(java.awt.Graphics g)` Paint the component's children.
`private void`	`paintChildrenOptimized(java.awt.Graphics g)` Paints the children of this container when it is marked as optimizedDrawingEnabled.
`private void`	`paintChildrenWithOverlap(java.awt.Graphics g)` Paints the children of this JComponent in the case when the component is not marked as optimizedDrawingEnabled, that means the container cannot guarantee that it's children are tiled.
`protected void`	`paintComponent(java.awt.Graphics g)` Paint the component's body.
`private void`	`paintDoubleBuffered(java.awt.Rectangle r)` Performs double buffered repainting.
`void`	`paintImmediately(int x, int y, int w, int h)` A variant of `paintImmediately(Rectangle)` 55 which takes integer parameters.
`void`	`paintImmediately(java.awt.Rectangle r)` Transform the provided dirty rectangle for this component into the appropriate ancestral JRootPane and call `paint(java.awt.Graphics)` 55 on that root pane.
`(package private) void`	`paintImmediately2(java.awt.Rectangle r)` Performs the actual work of paintImmediatly on the repaint root.
`(package private) void`	`paintSimple(java.awt.Rectangle r)` Performs normal painting without double buffering.
`protected java.lang.String`	`paramString()` Return a string representation for this component, for use in debugging.
`void`	`print(java.awt.Graphics g)` Prints this component to the given Graphics context.
`void`	`printAll(java.awt.Graphics g)` Prints this component to the given Graphics context.
`protected void`	`printBorder(java.awt.Graphics g)` Print this component's border to the specified Graphics context.
`protected void`	`printChildren(java.awt.Graphics g)` Print this component's children to the specified Graphics context.
`protected void`	`printComponent(java.awt.Graphics g)` Prints this component to the specified Graphics context.
`protected void`	`processComponentKeyEvent(java.awt.event.KeyEvent e)` A hook for subclasses which want to customize event processing.
`protected boolean`	`processKeyBinding(KeyStroke ks, java.awt.event.KeyEvent e, int condition, boolean pressed)`
`protected void`	`processKeyEvent(java.awt.event.KeyEvent e)` Override the default key dispatch system from Component to hook into the swing InputMap / ActionMap system.
`protected void`	`processMouseMotionEvent(java.awt.event.MouseEvent ev)` Processes mouse motion event, like dragging and moving.
`void`	`putClientProperty(java.lang.Object key, java.lang.Object value)` Add a client property `value` to this component, associated with `key`.
`void`	`registerKeyboardAction(java.awt.event.ActionListener act, KeyStroke stroke, int cond)` A variant of `registerKeyboardAction(ActionListener,String,KeyStroke,int)` 55 which provides `null` for the command name.
`void`	`registerKeyboardAction(java.awt.event.ActionListener act, java.lang.String cmd, KeyStroke stroke, int cond)` An obsolete method to register a keyboard action on this component.
`void`	`removeAncestorListener(javax.swing.event.AncestorListener listener)` Unregister an `AncestorListener`.
`void`	`removeNotify()` Receives notification that this component no longer has a parent.
`void`	`removeVetoableChangeListener(java.beans.VetoableChangeListener listener)` Unregister a `VetoableChangeChangeListener`.
`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.
`void`	`repaint(java.awt.Rectangle r)` Mark the described region of this component as dirty in the current RepaintManager.
`boolean`	`requestDefaultFocus()` Deprecated. Use `requestFocus()` 55 on the default component provided from the java.awt.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(javax.swing.JComponent)` 55 .
`void`	`scrollRectToVisible(java.awt.Rectangle r)` Calls `scrollRectToVisible` on the component's parent.
`void`	`setActionMap(ActionMap map)`
`void`	`setAlignmentX(float a)` Set the value of the `alignmentX` 55 property.
`void`	`setAlignmentY(float a)` Set the value of the `alignmentY` 55 property.
`void`	`setAutoscrolls(boolean a)` Set the value of the `autoscrolls` 55 property.
`void`	`setBackground(java.awt.Color bg)` Set the value of the `background` property.
`void`	`setBorder(javax.swing.border.Border newBorder)` Set the value of the `border` 55 property.
`void`	`setDebugGraphicsOptions(int debugOptions)` Set the value of the `debugGraphicsOptions` 55 property.
`static void`	`setDefaultLocale(java.util.Locale l)`
`void`	`setDoubleBuffered(boolean db)` Set the value of the `doubleBuffered` 55 property.
`void`	`setEnabled(boolean enable)` Set the value of the `enabled` property.
`void`	`setFont(java.awt.Font f)` Set the value of the `font` property.
`void`	`setForeground(java.awt.Color fg)` Set the value of the `foreground` property.
`void`	`setInputMap(int condition, InputMap map)`
`void`	`setInputVerifier(InputVerifier verifier)` Sets the input verifier to use by this component.
`void`	`setMaximumSize(java.awt.Dimension max)` Set the value of the `maximumSize` 55 property.
`void`	`setMinimumSize(java.awt.Dimension min)` Set the value of the `minimumSize` 55 property.
`void`	`setNextFocusableComponent(java.awt.Component aComponent)` Deprecated. Use FocusTraversalPolicy instead
`void`	`setOpaque(boolean isOpaque)` Set if the component should paint all pixels withing its bounds.
`void`	`setPreferredSize(java.awt.Dimension pref)` Set the value of the `preferredSize` 55 property.
`void`	`setRequestFocusEnabled(boolean e)` Set the value of the `requestFocusEnabled` 55 property.
`void`	`setToolTipText(java.lang.String text)` Set the value of the `toolTipText` 55 property.
`void`	`setTransferHandler(TransferHandler newHandler)` Set the value of the `transferHandler` 55 property.
`protected void`	`setUI(javax.swing.plaf.ComponentUI newUI)` Install a new UI delegate as the component's `ui` 55 property.
`(package private) void`	`setUIProperty(java.lang.String propertyName, java.lang.Object value)` Helper method for `LookAndFeel.installProperty(JComponent, String, Object)` 55 .
`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(java.awt.Graphics g)` Call `paint(java.awt.Graphics)` 55 .
`(package private) void`	`updateComponentInputMap(ComponentInputMap changed)` This is the method that gets called when the WHEN_IN_FOCUSED_WINDOW map is changed.
`void`	`updateUI()` This method should be overridden in subclasses.

javax.swing Class JComponent