Как Использовать Системный лоток

Системный лоток является специализированной областью рабочего стола, где пользователи могут получить доступ к в настоящий момент рабочим программам. Эта область может быть упомянута по-другому на различных операционных системах. На Microsoft Windows системный лоток упоминается как область Состояния Панели задач, в то время как на Среде Объектной модели Сети GNU (GNOME) Рабочий стол это упоминается как область уведомлений. На K Настольной среды (KDE) эта область упоминается как Системный лоток. Однако, на каждой системе область лотка совместно используется всеми приложениями, работающими на рабочем столе.

java.awt.SystemTray class, представленный в Java™ SE версия 6, представляет системный лоток для рабочего стола. К системному лотку можно получить доступ, вызывая помехи SystemTray.getSystemTray() метод. Прежде, чем вызвать этот метод, используйте статический метод isSupported() проверять, что системный лоток поддерживается. Если системный лоток не поддерживается на этой платформе, isSupported() метод возвращает false. Если приложение пытается вызвать getSystemTray() метод в таком случае, метод бросит a java.lang.UnsupportedOperationException.

Приложение не может создать экземпляр SystemTray class. Только единственный экземпляр, создаваемый в пределах этого class, может существовать, и этот экземпляр может быть получен, используя getSystemTray() метод.

Системный лоток содержит один или более значков лотка, которые добавляются к лотку, используя add(java.awt.TrayIcon) метод. Они могут быть удалены, когда они больше не необходимы с remove(java.awt.TrayIcon) метод.

TrayIcon Функциональность class идет вне значка, который выводится на экран в лотке. Это также включает текстовую подсказку, раскрывающееся меню, сообщения баллона, и ряд слушателей, связанных с этим. A TrayIcon объект генерирует различные события от нажатия мыши и поддерживает добавление соответствующих слушателей, чтобы получить уведомление об этих событиях. TrayIcon class обрабатывает некоторые из событий самостоятельно. Например, по умолчанию, когда щелчок правой кнопкой выполняется на значке лотка, он выводит на экран указанное раскрывающееся меню. Когда двойной щелчок выполняется, TrayIcon объект генерирует ActionEvent запустить приложение. Когда парения указателя мыши по значку лотка, подсказка выводится на экран. Изображение значка автоматически изменяется, чтобы соответствовать месту, выделенному для изображения на лотке.

Следующий демонстрационный пример, разработанное использование пакета AWT, демонстрирует функции классов SystemTray и TrayIcon.

К сожалению, текущая реализация TrayIcon class оказывает ограниченную поддержку Swing раскрывающееся меню ( JPopupMenu class), и не позволяет приложению использовать все возможности javax.swing пакет. Предложение по обходному решению по этой проблеме описывается в Базе данных Ошибки, см. ID Ошибки 6285881.

Следующий фрагмент кода показывает, как добавить значок лотка к системному лотку и применить раскрывающееся меню:

...
        //Check the SystemTray is supported
        if (!SystemTray.isSupported()) {
            System.out.println("SystemTray is not supported");
            return;
        }
        final PopupMenu pop-up = new PopupMenu();
        final TrayIcon trayIcon =
                new TrayIcon(createImage("images/bulb.gif", "tray icon"));
        final SystemTray tray = SystemTray.getSystemTray();
       
        // Create a pop-up menu components
        MenuItem aboutItem = new MenuItem("About");
        CheckboxMenuItem cb1 = new CheckboxMenuItem("Set auto size");
        CheckboxMenuItem cb2 = new CheckboxMenuItem("Set tooltip");
        Menu displayMenu = new Menu("Display");
        MenuItem errorItem = new MenuItem("Error");
        MenuItem warningItem = new MenuItem("Warning");
        MenuItem infoItem = new MenuItem("Info");
        MenuItem noneItem = new MenuItem("None");
        MenuItem exitItem = new MenuItem("Exit");
       
        //Add components to pop-up menu
        pop-up.add(aboutItem);
        pop-up.addSeparator();
        pop-up.add(cb1);
        pop-up.add(cb2);
        pop-up.addSeparator();
        pop-up.add(displayMenu);
        displayMenu.add(errorItem);
        displayMenu.add(warningItem);
        displayMenu.add(infoItem);
        displayMenu.add(noneItem);
        pop-up.add(exitItem);
       
        trayIcon.setPopupMenu(pop-up);
       
        try {
            tray.add(trayIcon);
        } catch (AWTException e) {
            System.out.println("TrayIcon could not be added.");
        }
...

Полный код для этого демонстрационного примера доступен в TrayIconDemo.java файл. Этот демонстрационный пример также использует bulb.gif файл изображения.

Удаление текущих ограничений на применение компонентов Swing позволит разработчикам добавить такие компоненты как JMenuItem (с изображением), JRadioButtonMenuItem, и JCheckBoxMenuItem.

API SystemTray

Только единственный экземпляр, создаваемый в пределах SystemTray class может существовать.

API TrayIcon

A TrayIcon объект представляет значок лотка, который может быть добавлен к системному лотку. A TrayIcon у объекта может быть подсказка (текст), изображение, раскрывающееся меню, и ряд слушателей, связанных с этим.

Примеры, Которые Используют API SystemTray