Swing ToolTip Tutorial with Example

📘 Premium Read: Access my best content on Medium member-only articles — deep dives into Java, Spring Boot, Microservices, backend architecture, interview preparation, career advice, and industry-standard best practices.

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (176K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

In this tutorial, we will learn how to add tooltip text to a Swing component using the setToolTipText(String s) method.

You may be interested in the below tutorials:

• Java Swing Hello World Example Tutorial 

• Java Swing Application with Database Connection 

• Login Application using Java Swing + JDBC + MySQL Example Tutorial 

• Registration Form using Java Swing + JDBC + MySQL Example Tutorial

javax.swing.JComponent.setToolTipText(String text) - This method registers the text to display in a tooltip. The text displays when the cursor lingers over the component.

Swing ToolTip Example

import java.awt.EventQueue;

import javax.swing.GroupLayout;
import javax.swing.JButton;
import javax.swing.JComponent;
import javax.swing.JFrame;
import javax.swing.JPanel;

/**
 * Class demonstrates to add tooltip.
 * @author javaguides.net
 *
 */
public class TooltipExample extends JFrame {

 private static final long serialVersionUID = 1L;

    private void initializeUI() {

     JButton btn = new JButton("Button");
        btn.setToolTipText("A button component");

        createLayout(btn);

        setTitle("Tooltip");
        setLocationRelativeTo(null);
        setDefaultCloseOperation(EXIT_ON_CLOSE);
    }

    private void createLayout(JComponent... arg) {

     JPanel pane = (JPanel) getContentPane();
     GroupLayout gl = new GroupLayout(pane);
        pane.setLayout(gl);

        pane.setToolTipText("Content pane");

        gl.setAutoCreateContainerGaps(true);

        gl.setHorizontalGroup(gl.createSequentialGroup()
                .addComponent(arg[0])
                .addGap(200)
        );

        gl.setVerticalGroup(gl.createSequentialGroup()
                .addComponent(arg[0])
                .addGap(120)
        );

        pack();
    }

    public static void main(String[] args) {

        EventQueue.invokeLater(() -> {
         TooltipExample tooltipExample = new TooltipExample();
         tooltipExample.initializeUI();
         tooltipExample.setVisible(true);
        });
    }
}

In the above example, we set a tooltip for the frame and the button. To enable a tooltip, we call the setTooltipText() method:

btn.setToolTipText("A button component");

A content pane is an instance of a JPanel component. The getContentPane() method returns a Container type. Since setting a tooltip requires a JComponent instance, we cast the object to a JPanel.

     JPanel pane = (JPanel) getContentPane();
     GroupLayout gl = new GroupLayout(pane);
        pane.setLayout(gl);

Note that a tooltip is set for the content pane:

pane.setToolTipText("Content pane");

We call the addGap() method for horizontal and vertical dimensions. It creates some space to the right and to the bottom of the button.

gl.setHorizontalGroup(gl.createSequentialGroup()
        .addComponent(arg[0])
        .addGap(200)
);

gl.setVerticalGroup(gl.createSequentialGroup()
        .addComponent(arg[0])
        .addGap(120)
);

The pack() method automatically sizes JFrame based on the size of its components:

pack();

Output

Related Swing Examples

• Java Swing Exit Button - In this post, I show you how to exit a Swing application when clicking on the exit button.

• Swing ToolTip Tutorial with Example - In this tutorial, we will learn how to add tooltip text to a Swing component.

• Java Swing BorderLayout Example - In this example, we will learn how to use BorderLayout in GUI/swing based applications.

• Java Swing GridLayout Tutorial with Examples - In this tutorial, we will learn how to use GridLayout in GUI/swing based applications.

• Swing Mouse Move Events using MouseMotionAdapter - In this tutorial, we will learn how to receive mouse motion events using MouseMotionAdapter.

• Java Swing CheckBox Example - In this post, I show you how to use JCheckBox class to create a Radio button in a Swing-based application.

• Java Swing Radio Button Example - In this post, I show you how to use JRadioButton class to create a Radio button in a Swing-based application.

• Java Swing Progress Bar Example - In this post, I show you how to create a progress bar using the JProgressBar component in swing-based applications.

• Java Swing Combo Box Example - In this post, I show you how to create a combo box using a JComboBox component in swing-based applications.

• Java Swing Slider Example - In this post, I show you how to create a slider using the JSlider component in swing-based applications.

• Java Swing Toggle Button Example - In this post, we will learn how to create a toggle button using the JToggleButton component in swing-based applications.