Package org.gvsig.fmap.mapcontrol.tools.Behavior

Interface IBehavior

All Known Implementing Classes:

BaseMapTool, Behavior, CircleBehavior, CompoundBehavior, DraggerBehavior, EllipseBehavior, FreehandBehavior, MouseMovementBehavior, MouseWheelBehavior, MoveBehavior, MoveWithMiddleButtonBehavior, PointBehavior, PolygonBehavior, PolylineBehavior, RectangleBehavior, TwoLinesBehavior

public interface IBehavior

When a programmer needs to add a way to permit user to interact with the current object where the graphical information is stored and represented, (see MapControl), must analyze and decide the basic behavior nature of the interaction.

That behavior will manage mouse events and generate information and tool events that the associated ToolListener will use to interact with the MapControl object ultimately.

It will be possible also combine more than one behavior for a tool listener, for having a richness tool.

Method Summary

Modifier and Type	Method	Description
Image	getImageCursor()	Gets the mouse cursor of the tool listener associated to this behavior.
ToolListener	getListener()	Gets the ToolListener used by this behavior to perform actions on the associated MapControl object.
MapControl	getMapControl()	Returns the reference to the MapControl object that this behavior uses.
void	mouseClicked(MouseEvent e)
void	mouseDragged(MouseEvent e)
void	mouseEntered(MouseEvent e)
void	mouseExited(MouseEvent e)
void	mouseMoved(MouseEvent e)
void	mousePressed(MouseEvent e)
void	mouseReleased(MouseEvent e)
void	mouseWheelMoved(MouseWheelEvent e)
void	paintComponent(MapControlDrawer renderer)	Method executed in real-time, when user is working with a tool on the associated MapControl object, repainting the MapControl's image.
void	setMapControl(MapControl mc)	Associates this behavior to a MapControl object.

Method Details

getListener

ToolListener getListener()

Gets the ToolListener used by this behavior to perform actions on the associated MapControl object.

Returns:

the ToolListener used by this behavior

paintComponent

void paintComponent(MapControlDrawer renderer)

Method executed in real-time, when user is working with a tool on the associated MapControl object, repainting the MapControl's image.

Returns immediately in all cases, even if the complete image has not yet been loaded.

This method will be implemented according to the specific nature of each behavior, and its extra and particular features.

See Also:

• Graphics.drawImage(java.awt.Image, int, int, java.awt.image.ImageObserver)

setMapControl

void setMapControl(MapControl mc)

Associates this behavior to a MapControl object.

Parameters:

mc - the MapControl object to associate

See Also:

• getMapControl()

getImageCursor

Image getImageCursor()

Gets the mouse cursor of the tool listener associated to this behavior.

Returns:

the mouse cursor of the tool listener associated

getMapControl

MapControl getMapControl()

Returns the reference to the MapControl object that this behavior uses.

Returns:

the MapControl object used this behavior

See Also:

• setMapControl(MapControl)

mouseClicked

void mouseClicked(MouseEvent e)
           throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse clicked event, by the IBehavior object

See Also:

• MouseListener.mouseClicked(java.awt.event.MouseEvent)

mouseEntered

void mouseEntered(MouseEvent e)
           throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse entered event, by the IBehavior object

See Also:

• MouseListener.mouseEntered(java.awt.event.MouseEvent)

mouseExited

void mouseExited(MouseEvent e)
          throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse exited event, by the IBehavior object

See Also:

• MouseListener.mouseExited(java.awt.event.MouseEvent)

mousePressed

void mousePressed(MouseEvent e)
           throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse pressed event, by the IBehavior object

See Also:

• MouseListener.mousePressed(java.awt.event.MouseEvent)

mouseReleased

void mouseReleased(MouseEvent e)
            throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse released event, by the IBehavior object

See Also:

• MouseListener.mouseReleased(java.awt.event.MouseEvent)

mouseDragged

void mouseDragged(MouseEvent e)
           throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse dragged event, by the IBehavior object

See Also:

• MouseMotionListener.mouseDragged(java.awt.event.MouseEvent)

mouseMoved

void mouseMoved(MouseEvent e)
         throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse moved event, by the IBehavior object

See Also:

• MouseMotionListener.mouseMoved(java.awt.event.MouseEvent)

mouseWheelMoved

void mouseWheelMoved(MouseWheelEvent e)
              throws BehaviorException

Throws:

BehaviorException - any exception processing the action associated to a mouse wheel event, by the IBehavior object

See Also:

• MouseWheelListener.mouseWheelMoved(java.awt.event.MouseWheelEvent)