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:

  • 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 Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • 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:

    • 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