y.view
Class HotSpotMode

java.lang.Object
  y.view.ViewMode
      y.view.HotSpotMode

All Implemented Interfaces:

MouseListener, MouseMotionListener, EventListener, MouseInputListener

Direct Known Subclasses:

HierarchyHotSpotMode

public class HotSpotMode
extends ViewMode

Handles hotspot drags. Causes selected nodes to change their size when the user drags one of the hotspots visible around such a node.

The mode is activated when the mouse is moved over a hotspot. It changes the mouse cursor according to the hotspot. In this state the HotSpotMode is *inactive*. When the left mouse button is pressed it goes into *active* mode.

This mode provides two modifiers to influence the resizing. The first one (isModifierPressed(java.awt.event.MouseEvent)) determines whether resizing shall keep the aspect ratio of the selected node(s). The second modifier (isKeepNodeCenterModifierPressed(java.awt.event.MouseEvent)) determines whether the selected node(s) shall keep their center locations when being resized. Both can be used in conjunction.

Field Summary

static byte	BLOCK_UPON_MINIMUM_SIZE Resize policy specifier.
static byte	DISCRETE_BLOCK_POLICY Resize policy specifier.
static byte	FLIP_SIDES_UPON_MINIMUM_SIZE Resize policy specifier.
static String	NODE_CENTER_RESIZING_MODIFIER_MASK_PROPERTY Property name constant used for PropertyChangeEvent.getPropertyName().
static byte	SEMI_BLOCK_UPON_MINIMUM_SIZE Resize policy specifier.

Fields inherited from class y.view.ViewMode

ACTIVE_PROPERTY, ACTIVE_VIEW_PROPERTY, CHILD_MODE_PROPERTY, EDITING_PROPERTY, GRAB_FOCUS_ENABLED_PROPERTY, lastClickEvent, lastDragEvent, lastMoveEvent, lastPressEvent, lastReleaseEvent, MODIFIER_MASK_PROPERTY, NAME_PROPERTY, originalX, originalY, PARENT_MODE_PROPERTY, view

Constructor Summary

HotSpotMode()
Instantiates a new HotSpotMode.

HotSpotMode(ViewContainer vc)
Instantiates a new HotSpotMode for a given ViewContainer

Method Summary

void	activate(boolean b) Invoked when the Mode is activated/deactivated from the ViewControl or via the setChild() and reactivateParent operations This behaves like a bound property using ViewMode.ACTIVE_PROPERTY as the property name.
protected void	adjustPortOffsets(Graph2D graph, Node node, double wOld, double hOld, double wNew, double hNew) Callback method that adjusts the ports of a NodeRealizer after that NodeRealizer's bounds have been changed.
void	cancelEditing() This can be used to cleanly exit an edit that is currently in progress.
protected void	cancelNodeResize() Calling this method cancels node resizing properly.
int	getCancelKeyCode() Sets the virtual key code as defined in KeyEvent which cancels the edge creation.
static Cursor	getCursor(byte hotSpotType) Returns a suitable cursor for the given hotSpotType.
int	getKeepNodeCenterModifierMask() Gets the current modifierMask for the second modifier.
byte	getResizePolicy() Returns the resize policy employed when dragging at a hotspot of a node.
protected boolean	isKeepNodeCenterModifierPressed(MouseEvent me) This method determines whether at the creation time of the given MouseEvent the modifier key was pressed.
protected boolean	isModifierPressed(MouseEvent me) This method determines whether at the creation time of the given MouseEvent the modifier key was pressed.
protected boolean	isOrthogonalRouting(Edge edge) Determines whether the given edge instance should be routed orthogonally.
void	mouseDraggedLeft(double x, double y) Resizes selected nodes.
void	mousePressedLeft(double x, double y) Initiates resizing of selected nodes.
void	mouseReleasedLeft(double x, double y) Terminates resizing of selected nodes.
void	reactivateParent() The parent of this ViewMode is reactivated and this ViewMode is deactivated.
void	setCancelKeyCode(int cancelKeyCode) Sets the virtual key code as defined in KeyEvent which cancels the edge creation.
void	setKeepNodeCenterModifierMask(int modifierMask) Sets the current modifierMask for the second modifier.
void	setResizePolicy(byte policy) Sets the resize policy employed when dragging one of the hotspots of a selected node.
protected void	updateNodeRealizerBounds(NodeRealizer vr, double x, double y, double w, double h) This method will be invoked by this view mode when the current bounds of a node need to be updated.

Methods inherited from class y.view.ViewMode

addPropertyChangeListener, addPropertyChangeListener, firePropertyChange, firePropertyChange, firePropertyChange, getChild, getGraph2D, getGridX, getGridY, getHitInfo, getHitInfo, getLastHitInfo, getModifierMask, getName, getParent, init, isActive, isEditing, isGrabFocusEnabled, isGridMode, mouseClicked, mouseClicked, mouseDragged, mouseDraggedMiddle, mouseDraggedRight, mouseEntered, mouseExited, mouseMoved, mouseMoved, mousePressed, mousePressedMiddle, mousePressedRight, mouseReleased, mouseReleased, mouseReleasedMiddle, mouseReleasedRight, mouseShiftPressedLeft, mouseShiftPressedMiddle, mouseShiftPressedRight, mouseShiftReleasedLeft, mouseShiftReleasedMiddle, mouseShiftReleasedRight, removePropertyChangeListener, removePropertyChangeListener, setActiveView, setChild, setChild, setEditing, setGrabFocusEnabled, setGridMode, setLastHitInfo, setModifierMask, setName, setParent, translateX, translateY

Methods inherited from class java.lang.Object

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

Field Detail

NODE_CENTER_RESIZING_MODIFIER_MASK_PROPERTY

public static final String NODE_CENTER_RESIZING_MODIFIER_MASK_PROPERTY

Property name constant used for PropertyChangeEvent.getPropertyName(). This property is used if setKeepNodeCenterModifierMask(int) is called.

See Also:

Constant Field Values

SEMI_BLOCK_UPON_MINIMUM_SIZE

public static final byte SEMI_BLOCK_UPON_MINIMUM_SIZE

Resize policy specifier. Unless a node has not yet reached minimum size, each drag gesture will cause the node to change its size. With this policy the mouse location can easily get out of sync with the active hotspot of a node. The minimum size is determined by a SizeConstraintProvider if provided using method NodeRealizer.getSizeConstraintProvider(). If no SizeConstraintProvider is provided the minimum size is 1,1 for normal nodes or determined by the minimum group bounds for open group nodes.

See Also:

setResizePolicy(byte), Constant Field Values

BLOCK_UPON_MINIMUM_SIZE

public static final byte BLOCK_UPON_MINIMUM_SIZE

Resize policy specifier. Resizes the nodes until a minimum size is reached. Resizing will be blocked whenever the mouse location is out of sync with the hotspot location. The minimum size is determined by a SizeConstraintProvider if provided using method NodeRealizer.getSizeConstraintProvider(). If no SizeConstraintProvider is provided the minimum size is 1,1 for normal nodes or determined by the minimum group bounds for open group nodes.

See Also:

setResizePolicy(byte), Constant Field Values

FLIP_SIDES_UPON_MINIMUM_SIZE

public static final byte FLIP_SIDES_UPON_MINIMUM_SIZE

Resize policy specifier. When the minimum size of a node is reached, the sides of the nodes will be exchanged so that the size of the node grows again.

See Also:

setResizePolicy(byte), Constant Field Values

DISCRETE_BLOCK_POLICY

public static final byte DISCRETE_BLOCK_POLICY

Resize policy specifier. Each node can be resized up to its minimal/maximal bounds. This policy supports keeping the aspect ratio (isModifierPressed(java.awt.event.MouseEvent)) as well as keeping the center locations (isKeepNodeCenterModifierPressed(java.awt.event.MouseEvent)) of selected nodes.

See Also:

setResizePolicy(byte), Constant Field Values

Constructor Detail

HotSpotMode

public HotSpotMode(ViewContainer vc)

Instantiates a new HotSpotMode for a given ViewContainer

HotSpotMode

public HotSpotMode()

Instantiates a new HotSpotMode.

Method Detail

setResizePolicy

public void setResizePolicy(byte policy)

Sets the resize policy employed when dragging one of the hotspots of a selected node.
Note: Only the DISCRETE_BLOCK_POLICY-policy supports the modifiers isModifierPressed(java.awt.event.MouseEvent) and isKeepNodeCenterModifierPressed(java.awt.event.MouseEvent).

Parameters:

policy - One of SEMI_BLOCK_UPON_MINIMUM_SIZE, BLOCK_UPON_MINIMUM_SIZE, FLIP_SIDES_UPON_MINIMUM_SIZE, or DISCRETE_BLOCK_POLICY.
By default, DISCRETE_BLOCK_POLICY is set.

getResizePolicy

public byte getResizePolicy()

Returns the resize policy employed when dragging at a hotspot of a node.

Returns:

the currently set resize policy

See Also:

setResizePolicy(byte)

mousePressedLeft

public void mousePressedLeft(double x,
                             double y)

Initiates resizing of selected nodes.

Overrides:

mousePressedLeft in class ViewMode

Parameters:

x - the x-coordinate of the mouse event in world coordinates.

y - the y-coordinate of the mouse event in world coordinates.

isOrthogonalRouting

protected boolean isOrthogonalRouting(Edge edge)

Determines whether the given edge instance should be routed orthogonally. This implementation uses the DataProvider bound to the current graph via the EditMode.ORTHOGONAL_ROUTING_DPKEY data provider key to determine whether the given edge should be routed orthogonally.

Parameters:

edge - the edge to decide

Returns:

true if the edge should be routed orthogonally.

See Also:

EditMode.isOrthogonalRouting(y.base.Edge)

mouseDraggedLeft

public void mouseDraggedLeft(double x,
                             double y)

Resizes selected nodes. Calls updateNodeRealizerBounds(NodeRealizer, double, double, double, double) and adjustPortOffsets(Graph2D, y.base.Node, double, double, double, double) for each node that is being resized.

Overrides:

mouseDraggedLeft in class ViewMode

Parameters:

x - the x-coordinate of the mouse event in world coordinates.

y - the y-coordinate of the mouse event in world coordinates.

isModifierPressed

protected boolean isModifierPressed(MouseEvent me)

Description copied from class: ViewMode

This method determines whether at the creation time of the given MouseEvent the modifier key was pressed. This implementation checks whether any of the bits in the modifierMask property of this class are set in the MouseEvents modifiers property. Subclasses may override this method to provide a more sophisticated implementation.

Overrides:

isModifierPressed in class ViewMode

See Also:

ViewMode.setModifierMask(int), ViewMode.getModifierMask()

isKeepNodeCenterModifierPressed

protected boolean isKeepNodeCenterModifierPressed(MouseEvent me)

This method determines whether at the creation time of the given MouseEvent the modifier key was pressed. This implementation checks whether any of the bits in the modifierMask property of this class are set in the MouseEvents modifiers property. Subclasses may override this method to provide a more sophisticated implementation. Modifier2 determines whether nodes shall be resized while keeping their center location.

See Also:

setKeepNodeCenterModifierMask(int), getKeepNodeCenterModifierMask()

setKeepNodeCenterModifierMask

public void setKeepNodeCenterModifierMask(int modifierMask)

Sets the current modifierMask for the second modifier. A modifier is assumed to be activated if (mouseEvent.getModifier() & modifierMask) != 0. Valid values are the static fields in the MouseEvent class.

Parameters:

modifierMask - the new modifier mask that will be used to determine whether the node shall be resized while keeping its center location.

getKeepNodeCenterModifierMask

public int getKeepNodeCenterModifierMask()

Gets the current modifierMask for the second modifier. A modifier is assumed to be activated if (mouseEvent.getModifier() & modifierMask) != 0. The default is MouseEvent.CTRL_MASK.

Returns:

the current modifier mask

adjustPortOffsets

protected void adjustPortOffsets(Graph2D graph,
                                 Node node,
                                 double wOld,
                                 double hOld,
                                 double wNew,
                                 double hNew)

Callback method that adjusts the ports of a NodeRealizer after that NodeRealizer's bounds have been changed.

Parameters:

graph - the graph that contains the node

node - the node whose ports shall be adjusted

wOld - the old width

hOld - the old height

wNew - the new width

hNew - the new height

updateNodeRealizerBounds

protected void updateNodeRealizerBounds(NodeRealizer vr,
                                        double x,
                                        double y,
                                        double w,
                                        double h)

This method will be invoked by this view mode when the current bounds of a node need to be updated.

Parameters:

vr - the realizer of the node whose bounds should change.

x - the desired x-coordinate of the node bounds.

y - the desired y-coordinate of the node bounds.

w - the desired width of the node.

h - the desired height of the node.

mouseReleasedLeft

public void mouseReleasedLeft(double x,
                              double y)

Terminates resizing of selected nodes.

Overrides:

mouseReleasedLeft in class ViewMode

Parameters:

x - the x-coordinate of the mouse event in world coordinates.

y - the y-coordinate of the mouse event in world coordinates.

activate

public void activate(boolean b)

Description copied from class: ViewMode

Invoked when the Mode is activated/deactivated from the ViewControl or via the setChild() and reactivateParent operations This behaves like a bound property using ViewMode.ACTIVE_PROPERTY as the property name.

Overrides:

activate in class ViewMode

Parameters:

b - set true when mode was activated false otherwise

reactivateParent

public void reactivateParent()

Description copied from class: ViewMode

The parent of this ViewMode is reactivated and this ViewMode is deactivated.

Overrides:

reactivateParent in class ViewMode

cancelNodeResize

protected void cancelNodeResize()

Calling this method cancels node resizing properly. After doing some cleanup it reactivates the parent if present.

getCursor

public static Cursor getCursor(byte hotSpotType)

Returns a suitable cursor for the given hotSpotType. The cursor indicates the kind of resize action that is being performed.

getCancelKeyCode

public int getCancelKeyCode()

Sets the virtual key code as defined in KeyEvent which cancels the edge creation. Negative values disable this feature. Default is KeyEvent.VK_ESCAPE.

setCancelKeyCode

public void setCancelKeyCode(int cancelKeyCode)

Sets the virtual key code as defined in KeyEvent which cancels the edge creation. Negative values disable this feature.

cancelEditing

public void cancelEditing()
                   throws UnsupportedOperationException

Description copied from class: ViewMode

This can be used to cleanly exit an edit that is currently in progress.
The implementation and interpretation of "canceling" is left to subclasses. This implementation does nothing but calls setEditing(false) if ViewMode.isEditing() returns true

Overrides:

cancelEditing in class ViewMode

Throws:

UnsupportedOperationException - if the editing cannot be canceled for any reason.