【博客搬家】Eclipse RCP应用系统开发方法与实战 5.6 实现系统托盘

最新推荐文章于 2024-02-17 17:57:55 发布

原创最新推荐文章于 2024-02-17 17:57:55 发布 · 961 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#eclipse #image #iterator #timer #null #shell

项目亲历专栏收录该内容

63 篇文章

订阅专栏

本文介绍如何在Eclipse RCP应用中实现系统托盘功能，包括托盘对象创建、事件监听处理及定时显示气泡提示文本等关键步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

http://book.youkuaiyun.com/bookfiles/493/10049317088.shtml

5.6 实现系统托盘将程序最小化到Windows托盘，是一项有趣而且实用的工作。程序启动后自动最小化到Windows托盘，如图5-15中所示。即使关闭程序，用户也可以随时通过托盘打开，非常方便快捷。

图5-15 经费测算系统的托盘菜单 5.6.1 托盘对象简介实现系统托盘首先需要获得Windows托盘对象，托盘对象可以通过Display对象的getSystemTray()方法取得，代码如下：
Tray tray = window.getShell().getDisplay().getSystemTray();

托盘对象的创建应该是在能够获得Display对象之后而程序窗口又没有打开之前，即ApplicationWorkbenchWindowAdvisor的postWindowOpen()方法中。
然后，向托盘对象中添加托盘项目TrayItem，并设置托盘项目的文字、图标。托盘项目及其图标应该在程序退出时销毁以释放资源。托盘项目创建方法如下：
TrayItem trayItem = new TrayItem(tray, SWT.NONE);
trayItem.setImage(trayImage);
trayItem.setToolTipText("文字说明");
最后，需要添加托盘项目的事件监听处理，主要有两种，一种是用户单击托盘图标时需要打开程序，其监听事件为：
trayItem.addListener(SWT.Selection, new Listener() {
     public void handleEvent(Event event) {
     //恢复程序界面
     }
});
另外一种是用户右键单击托盘图标时需要弹出菜单，其监听事件为：
trayItem.addListener(SWT.MenuDetect, new Listener() {
         public void handleEvent(Event event) {//处理代码}
     });
最后还有一个问题，当用户关闭程序时不能关闭托盘图标。这需要复写Application- WorkbenchWindowAdvisor的preWindowShellClose()方法。
5.6.2  系统托盘的具体实现1．创建管理托盘的HookSysTray类HookSysTray类实现托盘对象的创建和管理，其代码如下。
cn.edu.jfcs.sys / HookSysTray.java
import …
public class HookSysTray {
     private TrayItem trayItem;            //托盘项
     private Image trayImage;                   //托盘图标
     public HookSysTray() {}
     public void createSysTray(final IWorkbenchWindow window) {
         trayItem = initTrayItem(window); //初始化托盘
         if (trayItem != null) {
              trayPopupMenu(window);      //弹出托盘菜单项
              trayMinimize(window);       //最小化窗口到托盘
         }
     }
     // 用户单击窗口的最小化按钮时的处理
     public void windowMinimized(final Shell shell) {
         shell.setMinimized(true);            //最小化窗口
         shell.setVisible(false);             //窗口不可见
     }
     // 最小化程序到托盘
     private void trayMinimize(final IWorkbenchWindow window) {
         window.getShell().addShellListener(new ShellAdapter() {
              public void shellIconified(ShellEvent e) {
                   window.getShell().setVisible(false);
              }
         });
         //用户单击托盘图标时使得主程序窗口可见并恢复为正常大小
         trayItem.addListener(SWT.Selection, new Listener() {
              public void handleEvent(Event event) {
                   Shell shell = window.getShell();
                   if (!shell.isVisible()) {
                       shell.setVisible(true);
                       window.getShell().setMinimized(false);
                   }
              }
         });
     }
     // 托盘弹出菜单
     private void trayPopupMenu(final IWorkbenchWindow window) {
         trayItem.addListener(SWT.MenuDetect, new Listener() {
              public void handleEvent(Event event) {
                   MenuManager trayMenu = new MenuManager();  //创建菜单管理器
                   //创建菜单
                   Menu menu = trayMenu.createContextMenu(window.getShell());
                   fillTrayItem(trayMenu, window);       //给托盘项目加上菜单
                   menu.setVisible(true);               //菜单可见
              }
         });
     }
     // 构造托盘菜单项
     private void fillTrayItem(IMenuManager trayItem,
              final IWorkbenchWindow window) {
         //创建退出系统菜单
         Action exitSystem = new Action("退出系统[&E]", AbstractUIPlugin
                   .imageDescriptorFromPlugin(IAppConstants.APPLICATION_ID,
                            IImageKey.EXIT_SYSTEM)) {
              public void run() {
                   PlatformUI.getWorkbench().close();   //退出
              }
         };
         trayItem.add(new Logoff());                    //创建用户注销菜单
         trayItem.add(exitSystem);
     }
     // 初始化托盘项目的文字和图标
     private TrayItem initTrayItem(IWorkbenchWindow window) {
         //获得系统托盘
         final Tray tray = window.getShell().getDisplay().getSystemTray();
         if (tray == null)
              return null;
         trayItem = new TrayItem(tray, SWT.NONE);        //创建托盘项
         trayImage = AbstractUIPlugin.imageDescriptorFromPlugin(
                   IAppConstants.APPLICATION_ID, IImageKey .WINDOW_IMAGE)                 .createImage();                                    //创建托盘图像
         trayItem.setImage(trayImage);                      //设置托盘图标
         return trayItem;
     }
     public void Dispose() {
         if (trayItem != null)   trayItem.dispose();         //释放托盘
         if (trayImage != null)  trayImage.dispose();   //释放创建的图像资源
     }
}
程序说明：
l   程序向Windows托盘增加一个托盘图标和提示文字，并添加“用户注销”和“退出系统”两个托盘项。
l   MenuManager trayMenu = new MenuManager()是托盘的菜单管理器。
l   ExitSystem作为“退出系统”托盘项添加到托盘， PlatformUI.getWorkbench().close()用于关闭系统。
l   trayItem.add(new Logoff())中的new Logoff()生成“用户注销”Action，并作为托盘项添加到托盘。
2．修改ApplicationWorkbenchWindowAdvisor类l   首先定义一个HookSysTray 对象：
private HookSysTray hookSysTray;
l   添加用于创建hookSysTray对象的createSystemTray()方法：
private void createSystemTray() {
     hookSysTray = new HookSysTray();
     hookSysTray.createSysTray(getWindowConfigurer().getWindow());
}
l   修改postWindowOpen()方法，在该方法中调用createSystemTray()创建系统托盘：
public void postWindowOpen() {
     // 设置窗口自动居中
     Shell shell = getWindowConfigurer().getWindow().getShell();
     Rectangle screenSize = Display.getDefault().getClientArea();
     Rectangle frameSize = shell.getBounds();
     shell.setLocation((screenSize.width - frameSize.width) / 2,
              (screenSize.height - frameSize.height) / 2);
     createSystemTray();
}
l   改写preWindowShellClose()方法，防止关闭程序时关闭托盘：
public boolean preWindowShellClose() {
     hookSysTray.windowMinimized(getWindowConfigurer().getWindow().getShell());
     return false;
}
l   退出时释放资源：
public void dispose() {
     hookSysTray.Dispose();
}
5.6.3  图片的缓存处理创建图片是一项比较消耗系统资源的工作。众所周知，图片的使用原则是谁创建谁销毁以防止内存泄漏。系统使用图片的地方较多，因此应该统一高效地管理。将图片缓存起来，就可以在需要用到图片时直接从缓存中调用，而不是重新加载。下面是实现图片缓存处理的具体过程。
1．创建缓存CacheImage类CacheImage类负责创建、缓存、销毁图片等工作，以后凡是系统中需要使用图片的地方都由该类负责处理，代码如下。
cn.edu.jfcs.sys / CacheImage.java
import …
public class CacheImage {
     private final Map<String, Image> imageMap = new HashMap<String, Image>();
     private static CacheImage INSTANCE=new CacheImage();
     private CacheImage() {}
     //采用单例模式，整个系统共用一个CacheImage唯一实例
     public static CacheImage getINSTANCE(){
         return INSTANCE;
     }
     //获得图像
     public Image getImage(String applicationID,String imageName) {
         if (imageName == null)
              return null;
         Image image = (Image) imageMap.get(imageName);
         if (image == null) {
              image =AbstractUIPlugin.imageDescriptorFromPlugin(
                       applicationID,imageName).createImage();
              imageMap.put(imageName, image);//图像加入到Map中
         }
         return image;
     }
     //释放图像资源
     public void dispose() {
         //将Map对象转化成Iterator对象
         Iterator iterator = imageMap.values().iterator();
         while (iterator.hasNext())
              ((Image) iterator.next()).dispose();  //释放iterator中的图像资源
         imageMap.clear();                         //清除Map对象
     }
}
2．修改HookSysTray类l   去掉private Image trayImage语句。
l   修改初始化托盘项目initTrayItem()方法：
// 初始化托盘项目的文字和图标，代码中的黑体字部分为修改部分，下同。
private TrayItem initTrayItem(IWorkbenchWindow window) {
     final Tray tray = window.getShell().getDisplay().getSystemTray();
     if (tray == null)   return null;
     trayItem = new TrayItem(tray, SWT.NONE);
     trayItem.setImage(CacheImage.getINSTANCE().getImage(
              IAppConstants.APPLICATION_ID, IImageKey.WINDOW_IMAGE));
     trayItem.setToolTipText(IAppConstants.APPLICATION_TITLE);
     return trayItem;
}
3．修改ApplicationWorkbenchWindowAdvisor类的dispose()方法public void dispose() {
     hookSysTray.Dispose();
     CacheImage.getINSTANCE().dispose();
}
图像处理也可以采用图像描述符ImageDescriptor。ImageDescriptor的好处是不需要用户干预，由Java垃圾收集器自动释放和回收。前面创建Action时使用的就是图像描述符。当然，使用图像注册表ImageRegistry也是一个好方法，可以编写一个专门类利用图像注册表进行图像缓存管理。
5.6.4  定时自动显示托盘气泡提示文本气泡提示文本是一种非常友好的向用户展示信息的方式，很多软件的托盘图标都带有气泡提示文本，经常可见的气泡提示文本是向电脑插入U盘时显示的提示文本，其他还有瑞星杀毒软件、卡巴斯基、WindowsXP安全中心等等。Eclipse从3.2版本开始也支持气泡提示文本，图5-16即为气泡提示文本效果图。

图5-16  托盘气泡提示文本添加气泡提示文本其实非常简单，设置托盘项目trayItem的ToolTip就可以了。下面来实现一个能够每隔30分钟自动显示气泡提示文本的系统托盘，这需要修改初始化托盘项目文字和图标的initTrayItem()方法，黑体为新加代码。
private TrayItem initTrayItem(final IWorkbenchWindow window) {
     ……
     trayItem.setImage(CacheImage.getINSTANCE().getImage(
              IAppConstants.APPLICATION_ID, IImageKey.WINDOW_IMAGE));
     // 定时显示气泡提示文本
     Timer timer = new Timer();                      //创建定时器Timer
     timer.schedule(new TimerTask() {
         public void run() {
              window.getShell().getDisplay().asyncExec(new Runnable() {
                   public void run() {
                       ToolTip tip = new ToolTip(window.getShell(),
                                 SWT.BALLOON | SWT.ICON_INFORMATION);
                       tip.setAutoHide(true); //自动隐藏气泡式提示文本
                       //设置提示信息
                       tip.setMessage(IAppConstants.APPLICATION_TITLE);
                       tip.setText("欢迎使用");
                       trayItem.setToolTip(tip);
                       tip.setVisible(true);  //显示气泡式提示
                   }
              });
         }
     }, 0, 30 * 60 * 1000);
     return trayItem;
}
程序说明：
l   Timer是一个线程安全的定时器，这里设置的时间间隔为30分钟。为了调试程序时观察效果，可以设置得小一些，例如30秒（30×1000），调试好后再设置时间长些。
l   SWT.BALLOON设置提示文本为气泡式样，SWT.ICON_INFORMATION则表示带一个信息图标。
l   注意在Timer线程内部进行改变UI界面的操作时，需要使用window.getShell(). getDisplay().asyncExec()。