Java Swing
Java Swing
UI Elements: These are the core visual elements the user eventually sees and interacts
with. GWT provides a huge list of widely used and common elements varying from basic
to complex, which we will cover in this tutorial.
Layouts: They define how UI elements should be organized on the screen and provide a
final look and feel to the GUI (Graphical User Interface). This part will be covered in the
Layout chapter.
Behavior: These are the events which occur when the user interacts with UI elements.
This part will be covered in the Event Handling chapter.
Every SWING controls inherits properties from the following Component class hiearchy.
Sr.
Class & Description
No.
Component
1 A Component is the abstract base class for the non menu user-interface controls
of SWING. Component represents an object with graphical representation
Container
2
A Container is a component that can contain other SWING components
4
Java Swing
JComponent
A JComponent is a base class for all SWING UI components. In order to use a
3
SWING component that inherits from JComponent, the component must be in a
containment hierarchy whose root is a top-level SWING container
Component Class
Introduction
The class Component is the abstract base class for the non menu user-interface controls
of AWT. Component represents an object with graphical representation.
Class Declaration
Following is the declaration for java.awt.Component class:
Field
Following are the fields for java.awt.Component class:
Class Constructors
Sr.No. Constructor & Description
protected Component()
1
This creates a new Component
5
Java Swing
Class Methods
void addComponentListener(ComponentListener l)
3 Adds the specified component listener to receive the component events from
this component.
void addFocusListener(FocusListener l)
4
Adds the specified focus listener to receive focus events from this component,
when this component gains input focus.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
5 Adds the specified hierarchy bounds listener to receive hierarchy bounds events
from this component, when the hierarchy to which this container belongs
changes.
void addHierarchyListener(HierarchyListener l)
6 Adds the specified hierarchy listener to receive hierarchy changed events from
this component, when the hierarchy to which this container belongs changes.
void addInputMethodListener(InputMethodListener l)
7
Adds the specified input method listener to receive input method events from
this component.
void addKeyListener(KeyListener l)
8
Adds the specified key listener to receive key events from this component.
void addMouseListener(MouseListener l)
9 Adds the specified mouse listener to receive mouse events from this
component.
6
Java Swing
void addMouseMotionListener(MouseMotionListener l)
10
Adds the specified mouse motion listener to receive mouse motion events from
this component.
void addMouseWheelListener(MouseWheelListener l)
11
Adds the specified mouse wheel listener to receive mouse wheel events from
this component.
void addNotify()
12
Makes this Component displayable by connecting it to a native screen resource.
boolean contains(Point p)
20 Checks whether this component "contains" the specified point, where the point's
x and y coordinates are defined to be relative to the coordinate system of this
component.
void deliverEvent(Event e)
25
Deprecated. As of JDK version 1.1, replaced by dispatchEvent(AWTEvent e).
void disable()
26
Deprecated. As of JDK version 1.1, replaced by setEnabled(boolean).
void dispatchEvent(AWTEvent e)
28
Dispatches an event to this component or one of its sub components.
void doLayout()
29
Prompts the layout manager to lay out this component.
void enable()
30
Deprecated. As of JDK version 1.1, replaced by setEnabled(boolean).
31
void enable(boolean b)
8
Java Swing
9
Java Swing
AccessibleContext getAccessibleContext()
42
Gets the AccessibleContext associated with this Component.
float getAlignmentX()
43
Returns the alignment along the x axis.
float getAlignmentY()
44
Returns the alignment along the y axis.
Color getBackground()
45
Gets the background color of this component.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
47
Returns an enum indicating how the baseline of the component changes as the
size changes.
Rectangle getBounds()
48
Gets the bounds of this component in the form of a Rectangle object.
ColorModel getColorModel()
50
Gets the instance of ColorModel used to display the component on the output
device.
Component getComponentAt(Point p)
52
Returns the component or subcomponent that contains the specified point.
10
Java Swing
ComponentListener[] getComponentListeners()
53
Returns an array of all the component listeners registered on this component.
ComponentOrientation getComponentOrientation()
54
Retrieves the language-sensitive orientation that is to be used to order the
elements or the text within this component.
Cursor getCursor()
55
Gets the cursor set in the component.
DropTarget getDropTarget()
56
Gets the DropTarget associated with this Component.
Container getFocusCycleRootAncestor()
57
Returns the Container which is the focus cycle root of this Component's focus
traversal cycle.
FocusListener[] getFocusListeners()
58
Returns an array of all the focus listeners registered on this component.
boolean getFocusTraversalKeysEnabled()
60
Returns whether focus traversal keys are enabled for this Component.
Font getFont()
61
Gets the font of this component.
Color getForeground()
63
Gets the foreground color of this component.
64
Graphics getGraphics()
11
Java Swing
GraphicsConfiguration getGraphicsConfiguration()
65
Gets the GraphicsConfiguration associated with this Component.
int getHeight()
66
Returns the current height of this component.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
67
Returns an array of all the hierarchy bounds listeners registered on this
component.
HierarchyListener[] getHierarchyListeners()
68
Returns an array of all the hierarchy listeners registered on this component.
69 boolean getIgnoreRepaint()
InputContext getInputContext()
70
Gets the input context used by this component for handling the communication
with input methods, when the text is entered in this component.
InputMethodListener[] getInputMethodListeners()
71
Returns an array of all the input method listeners registered on this component.
InputMethodRequests getInputMethodRequests()
72
Gets the input method request handler which supports requests from input
methods for this component.
KeyListener[] getKeyListeners()
73
Returns an array of all the key listeners registered on this component.
75
Locale getLocale()
12
Java Swing
Point getLocation()
76
Gets the location of this component in the form of a point specifying the
component's top-left corner.
Point getLocationOnScreen()
78
Gets the location of this component in the form of a point specifying the
component's top-left corner in the screen's coordinate space.
Dimension getMaximumSize()
79
Gets the maximum size of this component.
Dimension getMinimumSize()
80
Gets the mininimum size of this component.
MouseListener[] getMouseListeners()
81
Returns an array of all the mouse listeners registered on this component.
MouseMotionListener[] getMouseMotionListeners()
82
Returns an array of all the mouse motion listeners registered on this
component.
Point getMousePosition()
83
Returns the position of the mouse pointer in this Component's coordinate space,
if the Component is directly under the mouse pointer, otherwise returns null.
MouseWheelListener[] getMouseWheelListeners()
84
Returns an array of all the mouse wheel listeners registered on this component.
String getName()
85
Gets the name of the component.
86
Container getParent()
13
Java Swing
java.awt.peer.ComponentPeer getPeer()
Dimension getPreferredSize()
88
Gets the preferred size of this component.
PropertyChangeListener[] getPropertyChangeListeners()
89
Returns an array of all the property change listeners registered on this
component.
PropertyChangeListener[] getPropertyChangeListeners(String
propertyName)
90
Returns an array of all the listeners which have been associated with the named
property.
Dimension getSize()
91
Returns the size of this component in the form of a Dimension object.
Toolkit getToolkit()
93
Gets the toolkit of this component.
Object getTreeLock()
94
Gets this component's locking object (the object that owns the thread
sychronization monitor) for AWT component-tree and layout operations.
int getWidth()
95
Returns the current width of this component.
int getX()
96
Returns the current x coordinate of the components origin.
14
Java Swing
int getY()
97
Returns the current y coordinate of the components origin.
boolean hasFocus()
100
Returns true if this Component is the focus owner.
void hide()
101
Deprecated. As of JDK version 1.1, replaced by setVisible(boolean).
void invalidate()
104
Invalidates this component.
boolean isBackgroundSet()
105 Returns whether the background color has been explicitly set for this
Component.
boolean isCursorSet()
106
Returns whether the cursor has been explicitly set for this Component.
boolean isDisplayable()
107
Determines whether this component is displayable.
15
Java Swing
boolean isDoubleBuffered()
108
Returns true if this component is painted to an offscreen image (buffer) that's
copied to the screen later.
boolean isEnabled()
109
Determines whether this component is enabled.
boolean isFocusable()
110
Returns whether this Component can be focused.
boolean isFocusOwner()
112
Returns true if this Component is the focus owner.
boolean isFocusTraversable()
113
Deprecated. As of 1.4, replaced by isFocusable().
boolean isFontSet()
114
Returns whether the font has been explicitly set for this Component.
boolean isForegroundSet()
115
Returns whether the foreground color has been explicitly set for this
Component.
boolean isLightweight()
116
A lightweight component doesn't have a native toolkit peer.
boolean isMaximumSizeSet()
117
Returns true if the maximum size has been set to a non-null value otherwise
returns false.
16
Java Swing
boolean isMinimumSizeSet()
118
Returns whether or not setMinimumSize has been invoked with a non-null
value.
boolean isOpaque()
119
Returns true if this component is completely opaque, returns false by default.
boolean isPreferredSizeSet()
120
Returns true if the preferred size has been set to a non-null value otherwise
returns false.
boolean isShowing()
121
Determines whether this component is showing on screen.
boolean isValid()
122
Determines whether this component is valid.
boolean isVisible()
123
Determines whether this component should be visible when its parent is visible.
void layout()
126
Deprecated. As of JDK version 1.1, replaced by doLayout().
void list()
127
Prints a listing of this component to the standard system output stream
System.out.
129
void list(PrintStream out,int indent)
17
Java Swing
Prints out a list, starting at the specified indentation, to the specified print
stream.
Point location()
133
Deprecated. As of JDK version 1.1, replaced by getLocation().
18
Java Swing
void nextFocus()
142 Deprecated. As of JDK version 1.1, replaced by transferFocus().
void paint(Graphics g)
143
Paints this component.
void paintAll(Graphics g)
144
Paints this component and all of its subcomponents.
boolean postEvent(Event e)
145
Deprecated. As of JDK version 1.1, replaced by dispatchEvent(AWTEvent).
void print(Graphics g)
147
Prints this component.
19
Java Swing
void printAll(Graphics g)
148
Prints this component and all of its subcomponents.
protectedvoid processComponentEvent(ComponentEvent e)
149
Processes component events occurring on this component by dispatching them
to any registered ComponentListener objects.
protectedvoid processInputMethodEvent(InputMethodEvent e)
154
Processes input method events occurring on this component by dispatching
them to any registered InputMethodListener objects.
20
Java Swing
void removeComponentListener(ComponentListener l)
160
Removes the specified component listener so that it no longer receives
component events from this component.
void removeFocusListener(FocusListener l)
161
Removes the specified focus listener so that it no longer receives focus events
from this component.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
162
Removes the specified hierarchy bounds listener so that it no longer receives
hierarchy bounds events from this component.
void removeHierarchyListener(HierarchyListener l)
163
Removes the specified hierarchy listener so that it no longer receives hierarchy
changed events from this component.
void removeInputMethodListener(InputMethodListener l)
164
Removes the specified input method listener so that it no longer receives input
method events from this component.
void removeKeyListener(KeyListener l)
165
Removes the specified key listener so that it no longer receives key events from
this component.
21
Java Swing
void removeMouseListener(MouseListener l)
166
Removes the specified mouse listener so that it no longer receives mouse
events from this component.
void removeMouseMotionListener(MouseMotionListener l)
167
Removes the specified mouse motion listener so that it no longer receives
mouse motion events from this component.
void removeMouseWheelListener(MouseWheelListener l)
168
Removes the specified mouse wheel listener so that it no longer receives mouse
wheel events from this component.
void removeNotify()
169
Makes this component undisplayable by destroying its native screen resource.
void repaint()
172
Repaints this component.
22
Java Swing
void requestFocus()
176
Requests that this component get the input focus, and that this component's
top-level ancestor become the focused Window.
boolean requestFocusInWindow()
178
Requests that this component get the input focus, if this component's top-level
ancestor is already the focused Window.
void resize(Dimension d)
181
Deprecated. As of JDK version 1.1, replaced by setSize(Dimension).
void setBackground(Color c)
183
Sets the background color of this component.
void setBounds(Rectangle r)
185 Moves and resizes this component to conform to the new bounding rectangle
r.
23
Java Swing
void setComponentOrientation(ComponentOrientation o)
186
Sets the language-sensitive orientation that is to be used to order the elements
or text within this component.
void setEnabled(boolean b)
189
Enables or disables this component, depending on the value of the parameter
b.
void setFocusTraversalKeysEnabled(boolean
192 focusTraversalKeysEnabled)
Sets whether focus traversal keys are enabled for this component.
void setFont(Font f)
193
Sets the font of this component.
void setForeground(Color c)
194
Sets the foreground color of this component.
24
Java Swing
void setLocale(Locale l)
196
Sets the locale of this component.
void setLocation(Point p)
198
Moves this component to a new location.
void setSize(Dimension d)
203
Resizes this component so that it has width d.width and height d.height.
void setVisible(boolean b)
205
Shows or hides this component depending on the value of parameter b.
void show()
206
Deprecated. As of JDK version 1.1, replaced by setVisible(boolean).
void show(boolean b)
207
Deprecated. As of JDK version 1.1, replaced by setVisible(boolean).
25
Java Swing
Dimension size()
208
Deprecated. As of JDK version 1.1, replaced by getSize().
String toString()
209
Returns a string representation of this component and its values.
void transferFocus()
210
Transfers the focus to the next component, as though this Component were the
focus owner.
void transferFocusBackward()
211
Transfers the focus to the previous component, as though this Component were
the focus owner.
void transferFocusUpCycle()
212
Transfers the focus up one focus traversal cycle.
void update(Graphics g)
213
Updates this component.
void validate()
214
Ensures that this component has a valid layout.
Rectangle bounds()
215
Deprecated. As of JDK version 1.1, replaced by getBounds().
219
Dimension preferredSize()
26
Java Swing
Dimension minimumSize()
221
Deprecated. As of JDK version 1.1, replaced by getMinimumSize().
27
Java Swing
28