SWING - Quick Guide

Swing API is a set of extensible GUI Components to ease the developer's life to create JAVA based Front End/GUI Applications. It is build on top of AWT API and acts as a replacement of AWT API, since it has almost every control corresponding to AWT controls. Swing component follows a Model-View-Controller architecture to fulfill the following criterias.
A single API is to be sufficient to support multiple look and feel.
A single API is to be sufficient to support multiple look and feel.
API is to be model driven so that the highest level API is not required to have data.
API is to be model driven so that the highest level API is not required to have data.
API is to use the Java Bean model so that Builder Tools and IDE can provide better services to the developers for use.
API is to use the Java Bean model so that Builder Tools and IDE can provide better services to the developers for use.
Swing API architecture follows loosely based MVC architecture in the following manner.
Model represents component's data.
Model represents component's data.
View represents visual representation of the component's data.
View represents visual representation of the component's data.
Controller takes the input from the user on the view and reflects the changes in Component's data.
Controller takes the input from the user on the view and reflects the changes in Component's data.
Swing component has Model as a seperate element, while the View and Controller part are clubbed in the User Interface elements. Because of which, Swing has a pluggable look-and-feel architecture.
Swing component has Model as a seperate element, while the View and Controller part are clubbed in the User Interface elements. Because of which, Swing has a pluggable look-and-feel architecture.
Light Weight − Swing components are independent of native Operating System's API as Swing API controls are rendered mostly using pure JAVA code instead of underlying operating system calls.
Light Weight − Swing components are independent of native Operating System's API as Swing API controls are rendered mostly using pure JAVA code instead of underlying operating system calls.
Rich Controls − Swing provides a rich set of advanced controls like Tree, TabbedPane, slider, colorpicker, and table controls.
Rich Controls − Swing provides a rich set of advanced controls like Tree, TabbedPane, slider, colorpicker, and table controls.
Highly Customizable − Swing controls can be customized in a very easy way as visual apperance is independent of internal representation.
Highly Customizable − Swing controls can be customized in a very easy way as visual apperance is independent of internal representation.
Pluggable look-and-feel − SWING based GUI Application look and feel can be changed at run-time, based on available values.
Pluggable look-and-feel − SWING based GUI Application look and feel can be changed at run-time, based on available values.
This section guides you on how to download and set up Java on your machine. Please use the following steps to set up the environment.
Java SE is freely available from the link Download Java. Hence, you can download a version based on your operating system.
Follow the instructions to download Java and run the .exe to install Java on your machine. Once you have installed Java on your machine, you would need to set the environment variables to point to the correct installation directories.
Assuming you have installed Java in c:\Program Files\java\jdk directory −
Step 1 − Right-click on 'My Computer' and select 'Properties'.
Step 2 − Click the 'Environment variables' button under the 'Advanced' tab.
Step 3 − Alter the 'Path' variable so that it also contains the path to the Java executable. Example, if the path is currently set to 'C:\WINDOWS\SYSTEM32', then change your path to read 'C:\WINDOWS\SYSTEM32;c:\Program Files\java\jdk\bin'.
Assuming you have installed Java in c:\Program Files\java\jdk directory −
Step 1 − Edit the 'C:\autoexec.bat' file and add the following line at the end: 'SET PATH=%PATH%;C:\Program Files\java\jdk\bin'.
Environment variable PATH should be set to point to where the Java binaries have been installed. Refer to your Shell documentation if you have trouble doing this.
Example, if you use bash as your shell, then you would add the following line to the end '.bashrc: export PATH=/path/to/java:$PATH'.
To write your Java programs, you will need a text editor. There are even more sophisticated IDE available in the market. But for now, you can consider one of the following −
Notepad − On Windows machine, you can use any simple text editor like Notepad (Recommended for this tutorial), TextPad.
Notepad − On Windows machine, you can use any simple text editor like Notepad (Recommended for this tutorial), TextPad.
Netbeans − Netbeans is a Java IDE that is open source and free, which can be downloaded from https://www.netbeans.org/index.html.
Netbeans − Netbeans is a Java IDE that is open source and free, which can be downloaded from https://www.netbeans.org/index.html.
Eclipse − Eclipse is also a Java IDE developed by the Eclipse open source community and can be downloaded from https://www.eclipse.org/.
Eclipse − Eclipse is also a Java IDE developed by the Eclipse open source community and can be downloaded from https://www.eclipse.org/.
Every user interface considers the following three main aspects −
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.
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.
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.
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.
A Component is the abstract base class for the non menu user-interface controls of SWING. Component represents an object with graphical representation
A Container is a component that can contain other SWING components
A JComponent is a base class for all SWING UI components. In order to use a SWING component that inherits from JComponent, the component must be in a containment hierarchy whose root is a top-level SWING container
Following is the list of commonly used controls while designing GUI using SWING.
A JLabel object is a component for placing text in a container.
This class creates a labeled button.
A JColorChooser provides a pane of controls designed to allow a user to manipulate and select a color.
A JCheckBox is a graphical component that can be in either an on (true) or off (false) state.
The JRadioButton class is a graphical component that can be in either an on (true) or off (false) state. in a group.
A JList component presents the user with a scrolling list of text items.
A JComboBox component presents the user with a to show up menu of choices.
A JTextField object is a text component that allows for the editing of a single line of text.
A JPasswordField object is a text component specialized for password entry.
A JTextArea object is a text component that allows editing of a multiple lines of text.
A ImageIcon control is an implementation of the Icon interface that paints Icons from Images
A Scrollbar control represents a scroll bar component in order to enable the user to select from range of values.
JOptionPane provides set of standard dialog boxes that prompt users for a value or informs them of something.
A JFileChooser control represents a dialog window from which the user can select a file.
As the task progresses towards completion, the progress bar displays the task's percentage of completion.
A JSlider lets the user graphically select a value by sliding a knob within a bounded interval.
A JSpinner is a single line input field that lets the user select a number or an object value from an ordered sequence.
In this chapter, you will learn about Events, its types, and also learn how to handle an event. Example is provided at the end of the chapter for better understanding.
Change in the state of an object is known as Event, i.e., event describes the change in the state of the source. Events are generated as a result of user interaction with the graphical user interface components. For example, clicking on a button, moving the mouse, entering a character through keyboard, selecting an item from the list, and scrolling the page are the activities that causes an event to occur.
The events can be broadly classified into two categories −
Foreground Events − These events require direct interaction of the user. They are generated as consequences of a person interacting with the graphical components in the Graphical User Interface. For example, clicking on a button, moving the mouse, entering a character through keyboard, selecting an item from list, scrolling the page, etc.
Foreground Events − These events require direct interaction of the user. They are generated as consequences of a person interacting with the graphical components in the Graphical User Interface. For example, clicking on a button, moving the mouse, entering a character through keyboard, selecting an item from list, scrolling the page, etc.
Background Events − These events require the interaction of the end user. Operating system interrupts, hardware or software failure, timer expiration, and operation completion are some examples of background events.
Background Events − These events require the interaction of the end user. Operating system interrupts, hardware or software failure, timer expiration, and operation completion are some examples of background events.
Event Handling is the mechanism that controls the event and decides what should happen if an event occurs. This mechanism has a code which is known as an event handler, that is executed when an event occurs.
Java uses the Delegation Event Model to handle the events. This model defines the standard mechanism to generate and handle the events.
The Delegation Event Model has the following key participants.
Source − The source is an object on which the event occurs. Source is responsible for providing information of the occurred event to it's handler. Java provide us with classes for the source object.
Source − The source is an object on which the event occurs. Source is responsible for providing information of the occurred event to it's handler. Java provide us with classes for the source object.
Listener − It is also known as event handler. The listener is responsible for generating a response to an event. From the point of view of Java implementation, the listener is also an object. The listener waits till it receives an event. Once the event is received, the listener processes the event and then returns.
Listener − It is also known as event handler. The listener is responsible for generating a response to an event. From the point of view of Java implementation, the listener is also an object. The listener waits till it receives an event. Once the event is received, the listener processes the event and then returns.
The benefit of this approach is that the user interface logic is completely separated from the logic that generates the event. The user interface element is able to delegate the processing of an event to a separate piece of code.
In this model, the listener needs to be registered with the source object so that the listener can receive the event notification. This is an efficient way of handling the event because the event notifications are sent only to those listeners who want to receive them.
Step 1 − The user clicks the button and the event is generated.
Step 2 − The object of concerned event class is created automatically and information about the source and the event get populated within the same object.
Step 3 − Event object is forwarded to the method of the registered listener class.
Step 4 − The method is gets executed and returns.
In order to design a listener class, you have to develop some listener interfaces. These Listener interfaces forecast some public abstract callback methods, which must be implemented by the listener class.
In order to design a listener class, you have to develop some listener interfaces. These Listener interfaces forecast some public abstract callback methods, which must be implemented by the listener class.
If you do not implement any of the predefined interfaces, then your class cannot act as a listener class for a source object.
If you do not implement any of the predefined interfaces, then your class cannot act as a listener class for a source object.
These are the methods that are provided by API provider and are defined by the application programmer and invoked by the application developer. Here the callback methods represent an event method. In response to an event, java jre will fire callback method. All such callback methods are provided in listener interfaces.
If a component wants some listener to listen ot its events, the source must register itself to the listener.
Create the following Java program using any editor of your choice in say D:/ > SWING > com > tutorialspoint > gui >
SwingControlDemo.java
package com.tutorialspoint.gui;

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;

public class SwingControlDemo {
   private JFrame mainFrame;
   private JLabel headerLabel;
   private JLabel statusLabel;
   private JPanel controlPanel;

   public SwingControlDemo(){
      prepareGUI();
   }
   public static void main(String[] args){
      SwingControlDemo swingControlDemo = new SwingControlDemo();  
      swingControlDemo.showEventDemo();       
   }
   private void prepareGUI(){
      mainFrame = new JFrame("Java SWING Examples");
      mainFrame.setSize(400,400);
      mainFrame.setLayout(new GridLayout(3, 1));

      headerLabel = new JLabel("",JLabel.CENTER );
      statusLabel = new JLabel("",JLabel.CENTER);        
      statusLabel.setSize(350,100);
      
      mainFrame.addWindowListener(new WindowAdapter() {
         public void windowClosing(WindowEvent windowEvent){
            System.exit(0);
         }        
      });    
      controlPanel = new JPanel();
      controlPanel.setLayout(new FlowLayout());

      mainFrame.add(headerLabel);
      mainFrame.add(controlPanel);
      mainFrame.add(statusLabel);
      mainFrame.setVisible(true);  
   }
   private void showEventDemo(){
      headerLabel.setText("Control in action: Button"); 

      JButton okButton = new JButton("OK");
      JButton submitButton = new JButton("Submit");
      JButton cancelButton = new JButton("Cancel");

      okButton.setActionCommand("OK");
      submitButton.setActionCommand("Submit");
      cancelButton.setActionCommand("Cancel");

      okButton.addActionListener(new ButtonClickListener()); 
      submitButton.addActionListener(new ButtonClickListener()); 
      cancelButton.addActionListener(new ButtonClickListener()); 

      controlPanel.add(okButton);
      controlPanel.add(submitButton);
      controlPanel.add(cancelButton);       

      mainFrame.setVisible(true);  
   }
   private class ButtonClickListener implements ActionListener{
      public void actionPerformed(ActionEvent e) {
         String command = e.getActionCommand();  
         
         if( command.equals( "OK" ))  {
            statusLabel.setText("Ok Button clicked.");
         } else if( command.equals( "Submit" ) )  {
            statusLabel.setText("Submit Button clicked."); 
         } else {
            statusLabel.setText("Cancel Button clicked.");
         }  	
      }		
   }
}
Compile the program using the command prompt. Go to D:/ > SWING and type the following command.
D:\AWT>javac com\tutorialspoint\gui\SwingControlDemo.java

If no error occurs, it means the compilation is successful. Run the program using the following command.
D:\AWT>java com.tutorialspoint.gui.SwingControlDemo

Verify the following output.
Event classes represent the event. Java provides various Event classes, however, only those which are more frequently used will be discussed.
It is the root class from which all event state objects shall be derived. All Events are constructed with a reference to the object, the source, that is logically deemed to be the object upon which the Event in question initially occurred upon. This class is defined in java.util package.
Following is the declaration for java.util.EventObject class −
public class EventObject
   extends Object
      implements Serializable

Following are the fields for java.util.EventObject class −
protected Object source − The object on which the Event initially occurred.
EventObject(Object source)
Constructs a prototypical Event.
Object getSource()
The object on which the Event initially occurred.
String toString()
Returns a String representation of this EventObject.
This class inherits methods from the following class −
java.lang.Object
Following is the list of commonly used Event classes.
It is the root event class for all SWING events. This class and its subclasses supercede the original java.awt.Event class.
The ActionEvent is generated when the button is clicked or the item of a list is double-clicked.
The InputEvent class is the root event class for all component-level input events.
On entering the character the Key event is generated.
This event indicates a mouse action occurred in a component.
The object of this class represents the change in the state of a window.
The object of this class represents the adjustment event emitted by Adjustable objects.
The object of this class represents the change in the state of a window.
The object of this class represents the change in the state of a window.
The object of this class represents the change in the state of a window.
The object of this class represents the change in the state of a window.
Event listeners represent the interfaces responsible to handle events. Java provides various Event listener classes, however, only those which are more frequently used will be discussed. Every method of an event listener method has a single argument as an object which is the subclass of EventObject class. For example, mouse event listener methods will accept instance of MouseEvent, where MouseEvent derives from EventObject.
It is a marker interface which every listener interface has to extend. This class is defined in java.util package.
Following is the declaration for java.util.EventListener interface −
public interface EventListener

Following is the list of commonly used event listeners.
This interface is used for receiving the action events.
This interface is used for receiving the component events.
This interface is used for receiving the item events.
This interface is used for receiving the key events.
This interface is used for receiving the mouse events.
This interface is used for receiving the window events.
This interface is used for receiving the adjustment events.
This interface is used for receiving the container events.
This interface is used for receiving the mouse motion events.
This interface is used for receiving the focus events.
Adapters are abstract classes for receiving various events. The methods in these classes are empty. These classes exist as convenience for creating listener objects.
Following is the list of commonly used adapters while listening GUI events in SWING.
An abstract adapter class for receiving focus events.
An abstract adapter class for receiving key events.
An abstract adapter class for receiving mouse events.
An abstract adapter class for receiving mouse motion events.
An abstract adapter class for receiving window events.
Layout refers to the arrangement of components within the container. In another way, it could be said that layout is placing the components at a particular position within the container. The task of laying out the controls is done automatically by the Layout Manager.
The layout manager automatically positions all the components within the container. Even if  you do not use the layout manager, the components are still positioned by the default layout manager. It is possible to lay out the controls by hand, however, it becomes very difficult because of the following two reasons.
It is very tedious to handle a large number of controls within the container.
It is very tedious to handle a large number of controls within the container.
Usually, the width and height information of a component is not given when we need to arrange them.
Usually, the width and height information of a component is not given when we need to arrange them.
Java provides various layout managers to position the controls. Properties like size, shape, and arrangement varies from one layout manager to the other. When the size of the applet or the application window changes, the size, shape, and arrangement of the components also changes in response, i.e. the layout managers adapt to the dimensions of the appletviewer or the application window.
The layout manager is associated with every Container object. Each layout manager is an object of the class that implements the LayoutManager interface.
Following are the interfaces defining the functionalities of Layout Managers.
The LayoutManager interface declares those methods which need to be implemented by the class, whose object will act as a layout manager.
The LayoutManager2 is the sub-interface of the LayoutManager. This interface is for those classes that know how to layout containers based on layout constraint object.
Following is the list of commonly used controls while designing GUI using AWT.
The borderlayout arranges the components to fit in the five regions: east, west, north, south, and center.
The CardLayout object treats each component in the container as a card. Only one card is visible at a time.
The FlowLayout is the default layout. It layout the components in a directional flow.
The GridLayout manages the components in the form of a rectangular grid.
This is the most flexible layout manager class. The object of GridBagLayout aligns the component vertically, horizontally, or along their baseline without requiring the components of the same size.
The GroupLayout hierarchically groups the components in order to position them in a Container.
A SpringLayout positions the children of its associated container according to a set of constraints.
As we know that every top-level window has a menu bar associated with it. This menu bar consists of various menu choices available to the end user. Further, each choice contains a list of options, which is called drop-down menus. Menu and MenuItem controls are subclass of MenuComponent class.
The JMenuBar object is associated with the top-level window.
The items in the menu must belong to the JMenuItem or any of its subclass.
The JMenu object is a pull-down menu component which is displayed from the menu bar.
JCheckboxMenuItem is the subclass of JMenuItem.
JRadioButtonMenuItem is the subclass of JMenuItem.
JPopupMenu can be dynamically popped up at a specified position within a component.
Containers are an integral part of SWING GUI components. A container provides a space where a component can be located. A Container in AWT is a component itself and it provides the capability to add a component to itself. Following are certain noticable points to be considered.
Sub classes of Container are called as Container. For example, JPanel, JFrame and JWindow.
Sub classes of Container are called as Container. For example, JPanel, JFrame and JWindow.
Container can add only a Component to itself.
Container can add only a Component to itself.
A default layout is present in each container which can be overridden using setLayout method.
A default layout is present in each container which can be overridden using setLayout method.
Following is the list of commonly used containers while designed GUI using SWING.
JPanel is the simplest container. It provides space in which any other component can be placed, including other panels.
A JFrame is a top-level window with a title and a border.
A JWindow object is a top-level window with no borders and no menubar.

    30 Lectures 
     3.5 hours 

 Pranjal Srivastava

    13 Lectures 
     1 hours 

 Pranjal Srivastava

    25 Lectures 
     4.5 hours 

 Emenwa Global, Ejike IfeanyiChukwu

    14 Lectures 
     1.5 hours 

 Travis Rose

    14 Lectures 
     1 hours 

 Travis Rose
 Print
 Add Notes
 Bookmark this page