diva.canvas.event

Class LayerEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

java.awt.event.InputEvent

java.awt.event.MouseEvent

diva.canvas.event.LayerEvent

All Implemented Interfaces:

Serializable

public class LayerEvent
extends MouseEvent

The class representing mouse events in layers. This class extends the AWT MouseEvent class, but adds the notion of floating-point coordinates and a "layer source" and "figure source" as well as a component source. Any code that processes a LayerEvent should be sure to use the methods getLayerX, getLayerY, getLayerPoint, instead of the inherited methods getX, getY, getPoint. (Originally, this class was designed to inherit from the AWT InputEvent class, which would have avoided the awkwardness of having two sets of coordinates in the same event object. This wasn't possible because InputEvent has only one package-scope constructor, and hence cannot be subclassed outside the AWT package.)

Version:

$Revision: 1.21 $

Author:

John Reekie

See Also:

Serialized Form

Field Summary

Fields inherited from class java.awt.event.MouseEvent

BUTTON1, BUTTON2, BUTTON3, MOUSE_CLICKED, MOUSE_DRAGGED, MOUSE_ENTERED, MOUSE_EXITED, MOUSE_FIRST, MOUSE_LAST, MOUSE_MOVED, MOUSE_PRESSED, MOUSE_RELEASED, MOUSE_WHEEL, NOBUTTON

Fields inherited from class java.awt.event.InputEvent

ALT_DOWN_MASK, ALT_GRAPH_DOWN_MASK, ALT_GRAPH_MASK, ALT_MASK, BUTTON1_DOWN_MASK, BUTTON1_MASK, BUTTON2_DOWN_MASK, BUTTON2_MASK, BUTTON3_DOWN_MASK, BUTTON3_MASK, CTRL_DOWN_MASK, CTRL_MASK, META_DOWN_MASK, META_MASK, SHIFT_DOWN_MASK, SHIFT_MASK

Fields inherited from class java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Fields inherited from class java.awt.AWTEvent

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
LayerEvent(MouseEvent e) Create a new layer event from the given mouse event.
LayerEvent(MouseEvent e, int id) Create a new layer event from the given mouse event, but give it a different ID.

Method Summary

Modifier and Type	Method and Description
void	consume() Consume this event.
Figure	getFigureSource() Get the figure that the event occurred on.
Point2D	getLayerPoint() Get the point where the event occured.
CanvasLayer	getLayerSource() Get the layer that the event occurred on.
double	getLayerX() Get the horizontal component of the point where the event occured.
double	getLayerY() Get the vertical component of the point where the event occured.
static String	idToString(int id) Print the string representation of an event ID
void	setFigureSource(Figure figureSource) Set the figure that the event occurred on.
void	setLayerPoint(Point2D point) Set the layer position of the event
void	setLayerSource(CanvasLayer layerSource) Set the layer that the event occurred on.
void	setLayerX(double x) Set the layer X position of the event
void	setLayerY(double y) Set the layer Y position of the event
String	toString() Print the string representation of this event
static String	toString(int flags) Print the string representation of modifier flags
void	transform(AffineTransform at) Transform the layer coordinates of the event with the given transform.

Methods inherited from class java.awt.event.MouseEvent

getButton, getClickCount, getLocationOnScreen, getModifiersEx, getMouseModifiersText, getPoint, getX, getXOnScreen, getY, getYOnScreen, isPopupTrigger, paramString, translatePoint

Methods inherited from class java.awt.event.InputEvent

getMaskForButton, getModifiers, getModifiersExText, getWhen, isAltDown, isAltGraphDown, isConsumed, isControlDown, isMetaDown, isShiftDown

Methods inherited from class java.awt.event.ComponentEvent

getComponent

Methods inherited from class java.awt.AWTEvent

getID, setSource

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

Constructor Detail

LayerEvent

public LayerEvent(MouseEvent e)

Create a new layer event from the given mouse event. The layer and figure event sources will be set to null, and the layer coordinates will be the same as the canvas coordinates.

LayerEvent

public LayerEvent(MouseEvent e,
                  int id)

Create a new layer event from the given mouse event, but give it a different ID. The layer and figure event sources will be set to null, and the layer coordinates will be the same as the canvas coordinates.

Method Detail

consume

public void consume()

Consume this event. If the event was constructed from a backing mouse event, consume the backing mouse event too.

Overrides:

consume in class InputEvent

getLayerSource

public CanvasLayer getLayerSource()

Get the layer that the event occurred on.

getFigureSource

public Figure getFigureSource()

Get the figure that the event occurred on. This is null if the event did not occur on a figure.

getLayerPoint

public Point2D getLayerPoint()

Get the point where the event occured. The point is in layer coordinates, and should be assumed to be a floating-point coordinate. This point is to be a copy of any internal data, so the caller can modify it.

getLayerX

public double getLayerX()

Get the horizontal component of the point where the event occured. The value is in layer coordinates, and should be assumed to be a floating-point coordinate.

getLayerY

public double getLayerY()

Get the vertical component of the point where the event occured. The value is in layer coordinates, and should be assumed to be a floating-point coordinate.

setFigureSource

public void setFigureSource(Figure figureSource)

Set the figure that the event occurred on.

setLayerSource

public void setLayerSource(CanvasLayer layerSource)

Set the layer that the event occurred on.

setLayerPoint

public void setLayerPoint(Point2D point)

Set the layer position of the event

setLayerX

public void setLayerX(double x)

Set the layer X position of the event

setLayerY

public void setLayerY(double y)

Set the layer Y position of the event

toString

public String toString()

Print the string representation of this event

Overrides:

toString in class AWTEvent

toString

public static String toString(int flags)

Print the string representation of modifier flags

idToString

public static String idToString(int id)

Print the string representation of an event ID

transform

public void transform(AffineTransform at)

Transform the layer coordinates of the event with the given transform.