org.openide.awt

Class MouseUtils.PopupMouseAdapter

java.lang.Object

java.awt.event.MouseAdapter

org.openide.awt.MouseUtils.PopupMouseAdapter

All Implemented Interfaces:

MouseListener, MouseMotionListener, MouseWheelListener, EventListener

Enclosing class:

MouseUtils

public abstract static class MouseUtils.PopupMouseAdapter
extends MouseAdapter

The PopupMouseAdapter provides safe way to implement popup menu invocation mechanism. It should be used instead of invoking the popup in mouseClicked because the mouseClicked does not work as "often" as it should (i.e. sometimes it is not called). PopupMouseAdapter delegates to isPopupTrigger to get correct popup menu invocation gesture. Clients are supposed to extend this class and implement showPopup method by adding code that shows popup menu properly.
Please note that older implementation which used treshold is now deprecated, please use default constructor.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_THRESHOLD Deprecated. Obsoleted as of 3.4, PopupMouseAdapter now uses isPopupTrigger properly. Threshold does nothing, please use default constructor without treshold.

Constructor Summary

Constructors

Constructor and Description
PopupMouseAdapter() Constructs PopupMouseAdapter.
PopupMouseAdapter(int threshold) Deprecated. Obsoleted as of 3.4, by class rewrite to use isPopupTrigger. This constructor now just delegates to super constructor, please use default constructor instead.

Method Summary

Modifier and Type	Method and Description
void	mousePressed(MouseEvent e)
void	mouseReleased(MouseEvent e)
protected abstract void	showPopup(MouseEvent evt) Called when the sequnce of mouse events should lead to actual showing of the popup menu.

Methods inherited from class java.awt.event.MouseAdapter

mouseClicked, mouseDragged, mouseEntered, mouseExited, mouseMoved, mouseWheelMoved

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_THRESHOLD

@Deprecated
public static final int DEFAULT_THRESHOLD

Deprecated. Obsoleted as of 3.4, PopupMouseAdapter now uses isPopupTrigger properly. Threshold does nothing, please use default constructor without treshold.

See Also:

Constant Field Values

Constructor Detail

PopupMouseAdapter

@Deprecated
public PopupMouseAdapter(int threshold)

Deprecated. Obsoleted as of 3.4, by class rewrite to use isPopupTrigger. This constructor now just delegates to super constructor, please use default constructor instead.

Creates a new PopupMouseAdapter with specified threshold

Parameters:

threshold - The threshold to be used

PopupMouseAdapter

public PopupMouseAdapter()

Constructs PopupMouseAdapter. Just delegates to super constructor

Method Detail

mousePressed

public void mousePressed(MouseEvent e)

Specified by:

mousePressed in interface MouseListener

Overrides:

mousePressed in class MouseAdapter

mouseReleased

public void mouseReleased(MouseEvent e)

Specified by:

mouseReleased in interface MouseListener

Overrides:

mouseReleased in class MouseAdapter

showPopup

protected abstract void showPopup(MouseEvent evt)

Called when the sequnce of mouse events should lead to actual showing of the popup menu. Should be redefined to show the menu. param evt The mouse release event - should be used to obtain the position of the popup menu