java.lang.Object
- org.openstreetmap.josm.gui.NotificationManager

```
class NotificationManager
extends java.lang.Object
```
Manages Notifications, i.e. displays them on screen.
Don't use this class directly, but use Notification.show().
If multiple messages are sent in a short period of time, they are put in a queue and displayed one after the other.
The user can stop the timer (freeze the message) by moving the mouse cursor above the panel. As a visual cue, the background color changes from semi-transparent to opaque while the timer is frozen.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`(package private) class`	`NotificationManager.FreezeMouseListener`
`private static class`	`NotificationManager.NotificationPanel`
`private class`	`NotificationManager.PauseFinishedEvent`
`static class`	`NotificationManager.RoundedPanel`	A panel with rounded edges and line border.
`private class`	`NotificationManager.UnfreezeEvent`

Field Summary

Fields
Modifier and Type	Field	Description
`private java.awt.event.ComponentListener`	`anchorListener`	keeps the displayed notification aligned when the layout around it changes, e.g.
`private Notification`	`currentNotification`
`private NotificationManager.NotificationPanel`	`currentNotificationPanel`
`private long`	`displayTimeStart`
`private long`	`elapsedTime`
`private javax.swing.Timer`	`hideTimer`
`private static NotificationManager`	`instance`
`private MapFrameListener`	`mapFrameListener`	brings the displayed notification over to the map view as soon as one is opened, and back when it is closed
`private static int`	`MARGIN`	margin between the notification panel and the borders of its anchor, in unscaled pixels
`private java.awt.Component`	`notificationAnchor`	the component `currentNotificationPanel` is aligned to, `null` while nothing is displayed
`private static java.awt.Color`	`PANEL_OPAQUE`
`private static java.awt.Color`	`PANEL_SEMITRANSPARENT`
`private static IntegerProperty`	`pauseTime`
`private javax.swing.Timer`	`pauseTimer`
`private java.util.Deque<Notification>`	`queue`
`private boolean`	`running`
`private java.awt.event.HierarchyListener`	`showingListener`	realigns the displayed notification when toggling fullscreen, before the window is painted with it at its old position
`private javax.swing.Timer`	`unfreezeDelayTimer`

Constructor Summary

Constructors
Constructor Description

NotificationManager()

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`private void`	`detachAnchorListener()`	Stops listening to the anchor of the notification that is no longer displayed.
`static NotificationManager`	`getInstance()`
`(package private) static java.awt.Point`	`getNotificationPosition(java.awt.Component anchor, java.awt.Container container, java.awt.Dimension size, int margin)`	Computes the position of a notification panel in the coordinate system of `container`, which unlike the one of the main window does not depend on the window decorations, i.e.
`private void`	`processQueue()`	Displays the next queued notification, unless one is being displayed already or the queue is empty.
`(package private) void`	`replaceExistingNotification(Notification oldNotification, Notification newNotification)`	Show the given notification by replacing the given queued/displaying notification
`(package private) void`	`showNotification(Notification note)`	Show the given notification (unless a duplicate notification is being shown at the moment or is already queued)
`private void`	`startHideTimer()`
`private void`	`stopHideTimer(Notification expected)`	Hides the displayed notification and starts the pause before the next one.
`private void`	`updateNotificationPosition()`	Aligns the displayed notification to the map view, or to the content pane while no map view is displayed, and keeps listening to that anchor for as long as the notification is displayed.

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

- Field Detail
  - hideTimer
```
private final javax.swing.Timer hideTimer
```
  - pauseTimer
```
private final javax.swing.Timer pauseTimer
```
  - unfreezeDelayTimer
```
private final javax.swing.Timer unfreezeDelayTimer
```
  - running
```
private boolean running
```
  - currentNotification
```
private Notification currentNotification
```
  - currentNotificationPanel
```
private NotificationManager.NotificationPanel currentNotificationPanel
```
  - notificationAnchor
```
private java.awt.Component notificationAnchor
```
    the component currentNotificationPanel is aligned to, null while nothing is displayed
  - anchorListener
```
private final java.awt.event.ComponentListener anchorListener
```
    keeps the displayed notification aligned when the layout around it changes, e.g. in fullscreen mode
  - showingListener
```
private final java.awt.event.HierarchyListener showingListener
```
    realigns the displayed notification when toggling fullscreen, before the window is painted with it at its old position
  - mapFrameListener
```
private final MapFrameListener mapFrameListener
```
    brings the displayed notification over to the map view as soon as one is opened, and back when it is closed
  - queue
```
private final java.util.Deque<Notification> queue
```
  - pauseTime
```
private static final IntegerProperty pauseTime
```
  - displayTimeStart
```
private long displayTimeStart
```
  - elapsedTime
```
private long elapsedTime
```
  - instance
```
private static NotificationManager instance
```
  - MARGIN
```
private static final int MARGIN
```
    margin between the notification panel and the borders of its anchor, in unscaled pixels
    
    See Also:
    
    Constant Field Values
  - PANEL_SEMITRANSPARENT
```
private static final java.awt.Color PANEL_SEMITRANSPARENT
```
  - PANEL_OPAQUE
```
private static final java.awt.Color PANEL_OPAQUE
```
- Constructor Detail
  - NotificationManager
```
NotificationManager()
```
- Method Detail
  - showNotification
```
void showNotification(Notification note)
```
    Show the given notification (unless a duplicate notification is being shown at the moment or is already queued)
    
    Parameters:
    
    note - The note to show.
    
    See Also:
    
    Notification.show()
  - replaceExistingNotification
```
void replaceExistingNotification(Notification oldNotification,
                                 Notification newNotification)
```
    Show the given notification by replacing the given queued/displaying notification
    
    Parameters:
    
    oldNotification - the notification to replace
    
    newNotification - the notification to show
  - processQueue
```
private void processQueue()
```
    Displays the next queued notification, unless one is being displayed already or the queue is empty.
    Only the state transition is guarded by the monitor of queue. The rest waits for the EDT, and the EDT takes that very monitor as well, so holding it any longer would deadlock every caller that is not the EDT itself.
  - updateNotificationPosition
```
private void updateNotificationPosition()
```
    Aligns the displayed notification to the map view, or to the content pane while no map view is displayed, and keeps listening to that anchor for as long as the notification is displayed.
  - detachAnchorListener
```
private void detachAnchorListener()
```
    Stops listening to the anchor of the notification that is no longer displayed.
  - getNotificationPosition
```
static java.awt.Point getNotificationPosition(java.awt.Component anchor,
                                              java.awt.Container container,
                                              java.awt.Dimension size,
                                              int margin)
```
    Computes the position of a notification panel in the coordinate system of container, which unlike the one of the main window does not depend on the window decorations, i.e. on fullscreen mode.
    The panel is aligned to the bottom left corner of anchor, or to its top left corner if it is taller, so that the beginning of a long message stays readable.
    
    Parameters:
    
    anchor - the component the notification is aligned to, e.g. the map view
    
    container - the container the notification panel is added to
    
    size - the size of the notification panel
    
    margin - the margin to keep between the notification panel and the borders of anchor
    
    Returns:
    
    the location of the upper left corner of the notification panel
  - startHideTimer
```
private void startHideTimer()
```
  - stopHideTimer
```
private void stopHideTimer(Notification expected)
```
    Hides the displayed notification and starts the pause before the next one.
    
    Parameters:
    
    expected - the notification to hide, or null for whichever is displayed. Nothing happens if another notification is displayed by now.
  - getInstance
```
public static NotificationManager getInstance()
```

Class NotificationManager

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

hideTimer

pauseTimer

unfreezeDelayTimer

running

currentNotification

currentNotificationPanel

notificationAnchor

anchorListener

showingListener

mapFrameListener

queue

pauseTime

displayTimeStart

elapsedTime

instance

MARGIN

PANEL_SEMITRANSPARENT

PANEL_OPAQUE

Constructor Detail

NotificationManager

Method Detail

showNotification

replaceExistingNotification

processQueue

updateNotificationPosition

detachAnchorListener

getNotificationPosition

startHideTimer

stopHideTimer

getInstance