TrayManager (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.desktopgui.TrayManager

Direct Known Subclasses:
ExternalTrayManager, InternalTrayManager
```
abstract class TrayManager
extends Object
```
Abstract base class for managing system tray icons and menus for I2P. Handles tray icon lifecycle, notifications, and provides platform-specific menu creation for both AWT and Swing implementations.

Field Summary

Fields
Modifier and Type	Field and Description
`protected I2PAppContext`	`_appContext` _appContext.
`protected JMenuItem`	`_jnotificationItem1` _jnotificationItem1.
`protected JMenuItem`	`_jnotificationItem2` _jnotificationItem2.
`protected MenuItem`	`_notificationItem1` _notificationItem1.
`protected MenuItem`	`_notificationItem2` _notificationItem2.
`protected boolean`	`_showNotifications` _showNotifications.
`protected boolean`	`_useSwing` _useSwing.
`protected static String`	`PROP_NOTIFICATIONS` PROP_NOTIFICATIONS.
`protected SystemTray`	`tray` tray.
`protected TrayIcon`	`trayIcon` trayIcon.

Constructor Summary
Constructors
Modifier Constructor and Description
protected TrayManager(I2PAppContext ctx, boolean useSwing)
Create a new tray manager.

Constructors
Modifier	Constructor and Description
`protected`	`TrayManager(I2PAppContext ctx, boolean useSwing)` Create a new tray manager.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`protected String`	`_t(String s)` Translate a string.
`protected String`	`_t(String s, Object o)` Translate a string with one parameter.
`protected void`	`configureNotifications(boolean enable)` Does not save.
`int`	`displayMessage(int priority, String title, String message, String path)` Send a notification to the user.
`protected abstract PopupMenu`	`getMainMenu()` Build a popup menu, adding callbacks to the different items.
`protected abstract JPopupMenu`	`getSwingMainMenu()` Build a popup menu, adding callbacks to the different items.
`protected void`	`initializeJNotificationItems()` Initializes _jnotificationItem 1 and 2
`protected void`	`initializeNotificationItems()` Initializes _notificationItem 1 and 2
`void`	`languageChanged()` Update the tray menu when the language changes.
`void`	`startManager()` Add the tray icon to the system tray and start everything up.
`void`	`stopManager()` Remove the tray icon from the system tray
`protected abstract void`	`updateMenu()` Update the menu

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - _appContext
```
protected final I2PAppContext _appContext
```
    _appContext.
  - _jnotificationItem1
```
protected JMenuItem _jnotificationItem1
```
    _jnotificationItem1.
  - _jnotificationItem2
```
protected JMenuItem _jnotificationItem2
```
    _jnotificationItem2.
  - _notificationItem1
```
protected MenuItem _notificationItem1
```
    _notificationItem1.
  - _notificationItem2
```
protected MenuItem _notificationItem2
```
    _notificationItem2.
  - _showNotifications
```
protected volatile boolean _showNotifications
```
    _showNotifications.
  - _useSwing
```
protected final boolean _useSwing
```
    _useSwing.
  - PROP_NOTIFICATIONS
```
protected static final String PROP_NOTIFICATIONS
```
    PROP_NOTIFICATIONS.
    See Also:
    Constant Field Values
  - tray
```
protected SystemTray tray
```
    tray.
  - trayIcon
```
protected TrayIcon trayIcon
```
    trayIcon.
- Constructor Detail
  - TrayManager
```
protected TrayManager(I2PAppContext ctx,
                      boolean useSwing)
```
    Create a new tray manager.
    Parameters:
    ctx - the I2P application context
    useSwing - true to use Swing components, false for AWT
- Method Detail
  - _t
```
protected String _t(String s)
```
    Translate a string.
    Parameters:
    s - the string to translate
    Returns:
    the translated string
  - _t
```
protected String _t(String s,
                    Object o)
```
    Translate a string with one parameter.
    Parameters:
    s - the string to translate
    o - the parameter to insert
    Returns:
    the translated string
  - configureNotifications
```
protected void configureNotifications(boolean enable)
```
    Does not save. See InternalTrayManager.
  - displayMessage
```
public int displayMessage(int priority,
                          String title,
                          String message,
                          String path)
```
    Send a notification to the user.
    Parameters:
    title - for the popup, translated
    message - translated
    path - unsupported
    Returns:
    0, or -1 on failure
  - getMainMenu
```
protected abstract PopupMenu getMainMenu()
```
    Build a popup menu, adding callbacks to the different items.
    Returns:
    popup menu
  - getSwingMainMenu
```
protected abstract JPopupMenu getSwingMainMenu()
```
    Build a popup menu, adding callbacks to the different items.
    Returns:
    popup menu
  - initializeJNotificationItems
```
protected void initializeJNotificationItems()
```
    Initializes _jnotificationItem 1 and 2
  - initializeNotificationItems
```
protected void initializeNotificationItems()
```
    Initializes _notificationItem 1 and 2
  - languageChanged
```
public void languageChanged()
```
    Update the tray menu when the language changes.
  - startManager
```
public void startManager()
                  throws AWTException
```
    Add the tray icon to the system tray and start everything up.
    Throws:
    AWTException - if the system tray is not supported
  - stopManager
```
public void stopManager()
```
    Remove the tray icon from the system tray
  - updateMenu
```
protected abstract void updateMenu()
```
    Update the menu

Class TrayManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

_appContext

_jnotificationItem1

_jnotificationItem2

_notificationItem1

_notificationItem2

_showNotifications

_useSwing

PROP_NOTIFICATIONS

tray

trayIcon

Constructor Detail

TrayManager

Method Detail

_t

_t

configureNotifications

displayMessage

getMainMenu

getSwingMainMenu

initializeJNotificationItems

initializeNotificationItems

languageChanged

startManager

stopManager

updateMenu