DISPLAYING ELEMENT-LEVEL TOOL TIPS FOR SWING COMPONENTS

原创 2001年10月19日 14:29:00

DISPLAYING ELEMENT-LEVEL TOOL TIPS FOR SWING COMPONENTS

Tool tips are those little popup windows that appear when you rest your mouse pointer over a control such as a button or list. All Swing components support tool tips. To establish a tool tip for a control, call setToolTipText() for the component. When a user rests the mouse pointer over the control, the tool tip automatically appears. Typically, you want one text string for an entire component. But there can be times when you want the text to be more flexible. For instance, in the case of a JList, JTree, or JTable component, you might want to display tool tip text based on which list entry, tree node, or table cell the mouse pointer is over. How can you customize the text?

There are two ways you can create custom tool tips for these Swing components. You can customize the control and override the public String getToolTipText(MouseEvent event) method, or you can customize the renderer for the control and let the renderer deal with the tool tips.

If you decide to override the getToolTipText() method, you have to understand that the passed-in MouseEvent contains the mouse coordinates over the control. It is your responsibility to determine what element the cursor is on. Then, you have to look up the appropriate tool tip text for the element and return that text. You must then manually register the component with the ToolTipManager. If you called the setToolTipText() method for the control, a call to the registerComponent() method of ToolTipManager would have been done for you, but because you don't need to call setToolTipText(), you must do the registration yourself.

Here's an example that demonstrates this first approach. The example uses the keys for the system properties (such as java.runtime.name) as the list entries. The example uses the property values (such as Java 2, Runtime Environment, Standard Edition) as the tool tip text for those entries.

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

    public class ListTest extends JList {

      DefaultListModel model;
      Properties tipProps;

      public ListTest(Properties props) {
        model = new DefaultListModel();
        setModel(model);
        ToolTipManager.sharedInstance().registerComponent(
                                             this);

        tipProps = props;
        Enumeration enum = props.propertyNames();
        while (enum.hasMoreElements()) {
          model.addElement(enum.nextElement());
        }
      }
      public String getToolTipText(MouseEvent event) {
        Point p = event.getPoint();
        int location = locationToIndex(p);
        String key = (String)model.getElementAt(
                                            location);
        String tip = tipProps.getProperty(key);
        return tip;
      }
      public static void main (String args[]) {
        JFrame frame = new JFrame("Custom Tips");
        frame.setDefaultCloseOperation(
                                JFrame.EXIT_ON_CLOSE);
        Properties props = System.getProperties();
        ListTest list = new ListTest(props);
        JScrollPane scrollPane = new JScrollPane(list);
        frame.getContentPane().add(scrollPane);
        frame.setSize(300, 300);
        frame.show();
      }
    }

If you decide instead to customize the cell renderer, you have to do a little more work at first, but you don't have to determine what element is under the mouse at run time. If you find that the tool tips are hardly used, though, this extra work might not be necessary. That's because getting cell renderers happens frequently, and the tool tip setup happens every time the cell is rendered. It might be better to use the first mechanism. Essentially, what it involves is calling the setToolTipText() method for the cell renderer.

Here's an example that demonstrates the cell renderer approach. The example is taken from the book "John Zukowski's Definitive Guide to Swing for Java 2, Second Edition" published by Apress.

First the renderer: this code essentially reuses a DefaultTreeCellRenderer as the renderer, setting its tip text.

    import javax.swing.*;
    import javax.swing.tree.*;
    import java.awt.*;
    import java.util.*;

    public class ToolTipTreeCellRenderer 
        implements TreeCellRenderer {
      DefaultTreeCellRenderer renderer = 
        new DefaultTreeCellRenderer();
      Dictionary tipTable;

      public ToolTipTreeCellRenderer (
                             Dictionary tipTable) {
        this.tipTable = tipTable;
      }

      public Component getTreeCellRendererComponent(
          JTree tree, Object value, boolean selected, 
          boolean expanded, boolean leaf, int row, 
          boolean hasFocus) {
        renderer.getTreeCellRendererComponent(
          tree, value, selected, expanded, leaf, row, 
                                            hasFocus);
        if (value != null) {
          Object tipKey;
          if (
             value instanceof DefaultMutableTreeNode) {
             tipKey = 
              ((DefaultMutableTreeNode)value).getUserObject();
          } else {
            tipKey = tree.convertValueToText(value, 
              selected, expanded, leaf, row, hasFocus);
          }
          Object tip = tipTable.get(tipKey);
          if (tip != null) {
            renderer.setToolTipText(tip.toString());
          } else {
            renderer.setToolTipText(null);
          }
        }
        return renderer;
      }
    }

The test program then just registers the tree with the ToolTipManager and registers the renderer. There is no need to subclass JTree. Like the JList example, the system properties are used for the component elements. In this case, the tree is only one level deep.

    import javax.swing.*;
    import javax.swing.tree.*;
    import java.awt.*;
    import java.util.*;

    public class TreeTips {
      public static void main(String args[]) {
        JFrame frame = new JFrame("Custom Tree Tips");
        frame.setDefaultCloseOperation(
                                 JFrame.EXIT_ON_CLOSE);
        Properties props = System.getProperties();
        JTree tree = new JTree(props);
        ToolTipManager.sharedInstance().registerComponent(
                                                 tree);
        TreeCellRenderer renderer = 
                    new ToolTipTreeCellRenderer(props);
        tree.setCellRenderer(renderer);
        JScrollPane scrollPane = new JScrollPane(tree);
        frame.getContentPane().add(
                      scrollPane, BorderLayout.CENTER);
        frame.setSize(300, 150);
        frame.setVisible(true);
      }
    }
<!-- Black Horizontal Line Begins Here -->

swing JTable学习(五)—中给table中的cell加tips 以及用AbstractTableModel创建表格

package tableTest; import java.awt.Point; import java.awt.event.MouseEvent; import java.awt.event.M...
  • lvyuan30276
  • lvyuan30276
  • 2015年03月18日 23:49
  • 740

swing JTable学习(四)—setTooltips换行

package ToolTipTest; import java.awt.Rectangle; import javax.swing.JButton; import javax.swing.JFr...
  • lvyuan30276
  • lvyuan30276
  • 2015年03月22日 18:29
  • 1082

Eclipse相关tips

1. 如何知道Eclipse的版本 Eclipse 3.1 版本代号 IO 【木卫1,伊奥】   Eclipse 3.2 版本代号 Callisto 【木卫四,卡里斯托 】   Eclips...
  • xhjx2618
  • xhjx2618
  • 2013年03月12日 14:40
  • 230

Eclipse 插件安装与卸载的10个小窍门

Eclipse Galileo拥有一个全新的插件安装对话框。事实上,整个过程完全重新分解了。这在Eclipse已成为一种惯例:Eclipse 3.3和3.4分别拥有完全不同的插件安装程序。51CTO编...
  • beyond_liyy
  • beyond_liyy
  • 2011年05月18日 16:04
  • 4713

提示框 9款css3 tooltips鼠标悬停显示消息提示框样式(精)

9款css3 tooltips鼠标悬停显示消息提示框样式查看原文查看在线演示Demo和更多原文内容教程:查看原文查看在线演示Demo和更多原文内容教程:9款不同的鼠标悬停显示Tooltips消息提示框...
  • xiaokui_wingfly
  • xiaokui_wingfly
  • 2016年07月13日 12:21
  • 2432

一个WPF的TOOLTIPS的界面效果(清爽)

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  xmlns:x="http://schemas.microso...
  • java3344520
  • java3344520
  • 2010年02月11日 18:37
  • 2833

几款好用的Tooltips 提示框插件

Poshy Tip 是一个强大的jQuery Tooltips插件,拥有不同的外观。作为 Form Tooltips使用时,可以自定义气泡出现的位置。(支持IE6~11) 演示地址:http:...
  • cddcj
  • cddcj
  • 2016年12月20日 18:00
  • 3442

Wix Components Xml Tool

因为要做wix安装包,要一行一行copy Components的xml描述太麻烦了,个人有点懒,不愿重复劳动;所以写了个小工具;来生成xml;原来一个小时的工作,因为有了小工具,一秒就搞定,何乐而不为...
  • wilsonke
  • wilsonke
  • 2012年08月28日 14:04
  • 918

CSS3实现漂亮ToolTips效果

(1)
  • AC_great
  • AC_great
  • 2015年03月25日 11:17
  • 994

Bootstrap简单认识之Tooltips组件

Tooltips(提示工具)组件一、简介 此组件用到了Tether插件,Tether一般用于搞定两个元素的位置关系,如下代码:new Tether({ // 此为主动附着元素 element:...
  • u012062760
  • u012062760
  • 2017年03月10日 17:11
  • 2167
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:DISPLAYING ELEMENT-LEVEL TOOL TIPS FOR SWING COMPONENTS
举报原因:
原因补充:

(最多只允许输入30个字)