edu.umd.cs.jazz.event
Class ZSelectionEventHandler

java.lang.Object
  |
  +--edu.umd.cs.jazz.event.ZSelectionEventHandler

All Implemented Interfaces:

java.util.EventListener, java.awt.event.KeyListener, java.io.Serializable, ZEventHandler, ZMouseListener, ZMouseMotionListener

public class ZSelectionEventHandler

extends java.lang.Object

implements ZEventHandler, ZMouseListener, ZMouseMotionListener, java.awt.event.KeyListener, java.io.Serializable

ZSelectionEventHandler provides event handlers for basic selection interaction.

Selection Actions (operates on the current selection):
• Click to select/unselect an item.
• Shift-click to extend the selection.
• Click-and-drag on the background to marquee select.
• Drag a selected item to move all of the selected items.
• Selected nodes may be moved with the mouse by dragging.
• Delete current selection with the DEL key.
• Translate items in currrent selection (nudge) with arrow keys.
• Scale items in current selection with PgUp / PgDown.

Warning: Serialized and ZSerialized objects of this class will not be compatible with future Jazz releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Jazz. A future release of Jazz will provide support for long term persistence.

See Also:

Serialized Form

Constructor Summary

ZSelectionEventHandler(ZNode node, ZCanvas canvas, ZGroup marqueeLayer)
Constructs a new ZSelectionEventHandler.

Method Summary

boolean	isActive() Determines if this event handler is active.
void	keyPressed(java.awt.event.KeyEvent e) Key press event handler
void	keyReleased(java.awt.event.KeyEvent e) Key release event handler
void	keyTyped(java.awt.event.KeyEvent e) Key typed event handler
void	mouseClicked(ZMouseEvent e) Invoked when the mouse has been clicked on a component.
void	mouseDragged(ZMouseEvent e) Mouse drag event handler
void	mouseEntered(ZMouseEvent e) Invoked when the mouse enters a component.
void	mouseExited(ZMouseEvent e) Invoked when the mouse exits a component.
void	mouseMoved(ZMouseEvent e) Invoked when the mouse button has been moved on a node (with no buttons no down).
void	mousePressed(ZMouseEvent e) Mouse press event handler
void	mouseReleased(ZMouseEvent e) Mouse release event handler
void	setActive(boolean active) Specifies whether this event handler is active or not.
void	setMarqueeLayer(ZGroup layer) Specify the node that the selection "marquee" should be put on.

Methods inherited from class java.lang.Object

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

Constructor Detail

ZSelectionEventHandler

public ZSelectionEventHandler(ZNode node,
                              ZCanvas canvas,
                              ZGroup marqueeLayer)

Constructs a new ZSelectionEventHandler.

Parameters:

node - The node this event handler attaches to.

canvas - The canvas this event handler attaches to

marqueeLayer - The layer to draw the marquee on

Method Detail

setActive

public void setActive(boolean active)

Specifies whether this event handler is active or not.

Specified by:

setActive in interface ZEventHandler

Parameters:

active - True to make this event handler active

isActive

public boolean isActive()

Determines if this event handler is active.

Specified by:

isActive in interface ZEventHandler

Returns:

True if active

setMarqueeLayer

public void setMarqueeLayer(ZGroup layer)

Specify the node that the selection "marquee" should be put on. The marquee is the rectangle that the user drags around to select things within.

Parameters:

layer - The node that the marquee should be put under

keyPressed

public void keyPressed(java.awt.event.KeyEvent e)

Key press event handler

Specified by:

keyPressed in interface java.awt.event.KeyListener

Parameters:

e - The event.

keyReleased

public void keyReleased(java.awt.event.KeyEvent e)

Key release event handler

Specified by:

keyReleased in interface java.awt.event.KeyListener

Parameters:

e - The event.

keyTyped

public void keyTyped(java.awt.event.KeyEvent e)

Key typed event handler

Specified by:

keyTyped in interface java.awt.event.KeyListener

Parameters:

e - The event.

mousePressed

public void mousePressed(ZMouseEvent e)

Mouse press event handler

Specified by:

mousePressed in interface ZMouseListener

Parameters:

e - The event.

mouseDragged

public void mouseDragged(ZMouseEvent e)

Mouse drag event handler

Specified by:

mouseDragged in interface ZMouseMotionListener

Parameters:

e - The event.

mouseReleased

public void mouseReleased(ZMouseEvent e)

Mouse release event handler

Specified by:

mouseReleased in interface ZMouseListener

Parameters:

e - The event.

mouseEntered

public void mouseEntered(ZMouseEvent e)

Invoked when the mouse enters a component.

Specified by:

mouseEntered in interface ZMouseListener

mouseExited

public void mouseExited(ZMouseEvent e)

Invoked when the mouse exits a component.

Specified by:

mouseExited in interface ZMouseListener

mouseClicked

public void mouseClicked(ZMouseEvent e)

Invoked when the mouse has been clicked on a component.

Specified by:

mouseClicked in interface ZMouseListener

mouseMoved

public void mouseMoved(ZMouseEvent e)

Invoked when the mouse button has been moved on a node (with no buttons no down).

Specified by:

mouseMoved in interface ZMouseMotionListener