fr.lri.swingstates.sm

Class JStateMachine

java.lang.Object

fr.lri.swingstates.sm.StateMachine

fr.lri.swingstates.sm.BasicInputStateMachine

fr.lri.swingstates.sm.JStateMachine

All Implemented Interfaces:

StateMachineListener, java.awt.event.ActionListener, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.MouseWheelListener, java.util.EventListener

Direct Known Subclasses:

PressDragReleaseStateMachine

public class JStateMachine
extends BasicInputStateMachine
implements java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.KeyListener

A state machine to monitor events with one or more Component.

The complete list of event types, i.e. classes of transitions, of a JStateMachine is:

• Press, PressOnComponent, PressOnTag: pressing a mouse button (anywhere / on a Component / on a Component with a given tag);
• Release, ReleaseOnComponent, ReleaseOnTag: releasing a mouse button (anywhere / on a Component / on a Component with a given tag);
• Click, ClickOnComponent, ClickOnTag: clicking (pressing and releasing in quick succession) a mouse button (anywhere / on a Component / on a Component with a given tag);
• Move, MoveOnComponent, MoveOnTag: moving the mouse with no button pressed (anywhere / on a Component / on a Component with a given tag);
• Drag, DragOnComponent, DragOnTag: moving the mouse with a button pressed (anywhere / on a Component / on a Component with a given tag);
• EnterOnComponent, EnterOnTag: cursor enters a Component / a Component with a given tag;
• LeaveOnComponent, LeaveOnTag: cursor leaves a Component / a Component with a given tag;
• KeyPress, KeyRelease, KeyType: typing a key (pressing, releasing, press then release in quick succession);
• TimeOut: delay specified by armTimer expired.

Author:

Caroline Appert

See Also:

BasicInputStateMachine

Field Summary

Fields inherited from class fr.lri.swingstates.sm.BasicInputStateMachine

ALT, ALT_CONTROL, ALT_CONTROL_SHIFT, ALT_SHIFT, ANYBUTTON, ANYMODIFIER, BUTTON1, BUTTON2, BUTTON3, CONTROL, CONTROL_SHIFT, NOBUTTON, NOMODIFIER, SHIFT

Fields inherited from class fr.lri.swingstates.sm.StateMachine

TIME_OUT

Constructor Summary

Constructors

Constructor and Description
JStateMachine() Builds a JStateMachine.

Method Summary

Methods

Modifier and Type	Method and Description
StateMachine	attachTo(java.awt.Component c) Attaches a component to this state machine.
StateMachine	detachFrom(java.awt.Component c) Removes a component from the control of this state machine.
static java.awt.Container	getContentPane(java.awt.Component c)
java.util.LinkedList	getControlledObjects()
static java.awt.Component	getGlassPane(java.awt.Component component)
void	keyPressed(java.awt.event.KeyEvent e)
void	keyReleased(java.awt.event.KeyEvent e)
void	keyTyped(java.awt.event.KeyEvent e)
void	mouseClicked(java.awt.event.MouseEvent e)
void	mouseDragged(java.awt.event.MouseEvent e)
void	mouseEntered(java.awt.event.MouseEvent e)
void	mouseExited(java.awt.event.MouseEvent e)
void	mouseMoved(java.awt.event.MouseEvent e)
void	mousePressed(java.awt.event.MouseEvent e)
void	mouseReleased(java.awt.event.MouseEvent e)
void	processEvent(java.util.EventObject event) Processes in the state machine the virtual event received.

Methods inherited from class fr.lri.swingstates.sm.BasicInputStateMachine

addAsListenerOf, mouseWheelMoved, removeAsListenerOf

Methods inherited from class fr.lri.swingstates.sm.StateMachine

actionPerformed, addStateMachineListener, addStateMachineListener, armTimer, armTimer, consumes, disarmTimer, disarmTimer, doReset, doResume, doSuspend, eventOccured, fireEvent, fireEvent, getAllStates, getCurrentState, getInitialState, getState, hasConsumed, init, initStatesAndTransitions, isActive, isInited, processEvent, removeStateMachineListener, removeStateMachineListener, reset, resume, setActive, suspend

Methods inherited from class java.lang.Object

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

Constructor Detail

JStateMachine

public JStateMachine()

Builds a JStateMachine.

Method Detail

attachTo

public StateMachine attachTo(java.awt.Component c)

Attaches a component to this state machine. Events coming on this component and its children are caught by this state machine. If this component has a glasspane, events will still reach the underlying widgets in a JStateMachine (the glasspane must be set before calling this attachTo method).

Parameters:

c - The component to attach.

Returns:

This state machine.

detachFrom

public StateMachine detachFrom(java.awt.Component c)

Removes a component from the control of this state machine.

Parameters:

c - The component to detach.

Returns:

This state machine.

getControlledObjects

public java.util.LinkedList getControlledObjects()

Returns:

The Components monitored by this state machine as a linked list.

mouseClicked

public void mouseClicked(java.awt.event.MouseEvent e)

Specified by:

mouseClicked in interface java.awt.event.MouseListener

Overrides:

mouseClicked in class BasicInputStateMachine

mousePressed

public void mousePressed(java.awt.event.MouseEvent e)

Specified by:

mousePressed in interface java.awt.event.MouseListener

Overrides:

mousePressed in class BasicInputStateMachine

mouseReleased

public void mouseReleased(java.awt.event.MouseEvent e)

Specified by:

mouseReleased in interface java.awt.event.MouseListener

Overrides:

mouseReleased in class BasicInputStateMachine

mouseEntered

public void mouseEntered(java.awt.event.MouseEvent e)

Specified by:

mouseEntered in interface java.awt.event.MouseListener

Overrides:

mouseEntered in class BasicInputStateMachine

mouseExited

public void mouseExited(java.awt.event.MouseEvent e)

Specified by:

mouseExited in interface java.awt.event.MouseListener

Overrides:

mouseExited in class BasicInputStateMachine

getGlassPane

public static java.awt.Component getGlassPane(java.awt.Component component)

processEvent

public void processEvent(java.util.EventObject event)

Description copied from class: StateMachine

Processes in the state machine the virtual event received.

Overrides:

processEvent in class StateMachine

Parameters:

event - The virtual event to process

mouseDragged

public void mouseDragged(java.awt.event.MouseEvent e)

Specified by:

mouseDragged in interface java.awt.event.MouseMotionListener

Overrides:

mouseDragged in class BasicInputStateMachine

mouseMoved

public void mouseMoved(java.awt.event.MouseEvent e)

Specified by:

mouseMoved in interface java.awt.event.MouseMotionListener

Overrides:

mouseMoved in class BasicInputStateMachine

keyTyped

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

Specified by:

keyTyped in interface java.awt.event.KeyListener

Overrides:

keyTyped in class BasicInputStateMachine

keyPressed

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

Specified by:

keyPressed in interface java.awt.event.KeyListener

Overrides:

keyPressed in class BasicInputStateMachine

keyReleased

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

Specified by:

keyReleased in interface java.awt.event.KeyListener

Overrides:

keyReleased in class BasicInputStateMachine

getContentPane

public static java.awt.Container getContentPane(java.awt.Component c)