Module java.desktop
Package javax.swing.plaf.basic

# Class BasicMenuUI.MouseInputHandler

java.lang.Object
javax.swing.plaf.basic.BasicMenuUI.MouseInputHandler

All Implemented Interfaces:
  `MouseListener`, `MouseMotionListener`, `EventListener`, `MouseInputListener`

Enclosing class:
  `BasicMenuUI`

protected class BasicMenuUI.MouseInputHandler extends Object implements MouseInputListener
Instantiated and used by a menu item to handle the current menu selection from mouse events. A MouseInputHandler processes and forwards all mouse events to a shared instance of the MenuSelectionManager.

This class is protected so that it can be subclassed by other look and feels to implement their own mouse handling behavior. All overridden methods should call the parent methods so that the menu selection is correct.

Since:
  1.4
See Also:
  - `MenuSelectionManager`

## Constructor Summary

Constructors
Modifier
Constructor
Description
`protected`
`MouseInputHandler()`
Constructs a `MouseInputHandler`.

## Method Summary

Modifier and Type
Method
Description
`void`
`mouseClicked(MouseEvent e)`
Invoked when the mouse button has been clicked (pressed and released) on a component.
`void`
`mouseDragged(MouseEvent e)`
Invoked when a mouse button is pressed on the menu and then dragged.
`void`
`mouseEntered(MouseEvent e)`
Invoked when the cursor enters the menu.
`void`
`mouseExited(MouseEvent e)`
Invoked when the mouse exits a component.
`void`
`mouseMoved(MouseEvent e)`
Invoked when the mouse cursor has been moved onto a component but no buttons have been pushed.
`void`
`mousePressed(MouseEvent e)`
Invoked when the mouse has been clicked on the menu.
`void`
`mouseReleased(MouseEvent e)`
Invoked when the mouse has been released on the menu.

### Methods declared in class java.lang.Object

`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

## Constructor Details

### MouseInputHandler

protected MouseInputHandler()
Constructs a `MouseInputHandler`.

## Method Details

### mouseClicked

public void mouseClicked(MouseEvent e)
Description copied from interface: `MouseListener`
Invoked when the mouse button has been clicked (pressed and released) on a component.

Specified by:
  `mouseClicked` in interface `MouseListener`
Parameters:
  `e` - the event to be processed

### mousePressed

public void mousePressed(MouseEvent e)
Invoked when the mouse has been clicked on the menu. This method clears or sets the selection path of the MenuSelectionManager.

Specified by:
  `mousePressed` in interface `MouseListener`
Parameters:
  `e` - the mouse event

### mouseReleased

public void mouseReleased(MouseEvent e)
Invoked when the mouse has been released on the menu. Delegates the mouse event to the MenuSelectionManager.

Specified by:
  `mouseReleased` in interface `MouseListener`
Parameters:
  `e` - the mouse event

### mouseEntered

public void mouseEntered(MouseEvent e)
Invoked when the cursor enters the menu. This method sets the selected path for the MenuSelectionManager and handles the case in which a menu item is used to pop up an additional menu, as in a hierarchical menu system.

Specified by:
  `mouseEntered` in interface `MouseListener`
Parameters:
  `e` - the mouse event; not used

### mouseExited

public void mouseExited(MouseEvent e)
Description copied from interface: `MouseListener`
Invoked when the mouse exits a component.

Specified by:
  `mouseExited` in interface `MouseListener`
Parameters:
  `e` - the event to be processed

### mouseDragged

public void mouseDragged(MouseEvent e)
Invoked when a mouse button is pressed on the menu and then dragged. Delegates the mouse event to the MenuSelectionManager.

Specified by:
  `mouseDragged` in interface `MouseMotionListener`
Parameters:
  `e` - the mouse event
See Also:
  - `MouseMotionListener.mouseDragged(java.awt.event.MouseEvent)`

### mouseMoved

public void mouseMoved(MouseEvent e)
Description copied from interface: `MouseMotionListener`
Invoked when the mouse cursor has been moved onto a component but no buttons have been pushed.

Specified by:
  `mouseMoved` in interface `MouseMotionListener`
Parameters:
  `e` - the event to be processed