Package edu.cnu.mdi.sim.ui

Class IconSimulationControlPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

edu.cnu.mdi.sim.ui.IconSimulationControlPanel

All Implemented Interfaces:

SimulationListener, ISimulationControlPanel, ImageObserver, MenuContainer, Serializable, Accessible

public class IconSimulationControlPanel
extends JPanel
implements SimulationListener, ISimulationControlPanel

A more graphical variant of SimulationControlPanel that prefers icons and supports either an indeterminate "busy" graphic (when available) or an indeterminate progress bar fallback.

MDI-agnostic: icons are supplied by an IconSimulationControlPanel.IconProvider.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	IconSimulationControlPanel.IconProvider

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
IconSimulationControlPanel(IconSimulationControlPanel.IconProvider icons, boolean includeStartButton)

Method Summary

Modifier and Type	Method	Description
void	bind(ISimulationHost host)	Bind this panel to a host: stores the host reference, registers this panel as a SimulationListener, and updates the UI to reflect the host's current state.
void	onCancelRequested(SimulationContext ctx)	Called when cancellation is requested via SimulationEngine.requestCancel().
void	onDone(SimulationContext ctx)	Called when the engine ends normally (reaches SimulationState.TERMINATED).
void	onFail(SimulationContext ctx, Throwable error)	Called when the engine fails (reaches SimulationState.FAILED).
void	onMessage(SimulationContext ctx, String message)	Called for status/log messages intended for UI display.
void	onPause(SimulationContext ctx)	Called when the engine enters SimulationState.PAUSED.
void	onProgress(SimulationContext ctx, ProgressInfo progress)	Called for progress updates (indeterminate or determinate).
void	onRefresh(SimulationContext ctx)	Called for a graphics refresh/update event.
void	onResume(SimulationContext ctx)	Called when the engine resumes from SimulationState.PAUSED back to SimulationState.RUNNING.
void	onRun(SimulationContext ctx)	Called when the engine begins execution (enters SimulationState.RUNNING).
void	onStateChange(SimulationContext ctx, SimulationState from, SimulationState to, String reason)	Called on every state transition.
static IconSimulationControlPanel	simplifiedPanel(boolean includeStartButton)
void	unbind()	Release any current host binding.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface edu.cnu.mdi.sim.SimulationListener

onCompleted, onInit, onReady

Constructor Details

IconSimulationControlPanel

public IconSimulationControlPanel(IconSimulationControlPanel.IconProvider icons,
 boolean includeStartButton)

Method Details

bind

public void bind(ISimulationHost host)

Bind this panel to a host: stores the host reference, registers this panel as a SimulationListener, and updates the UI to reflect the host's current state.

Note: this method does not implicitly unbind first. Calling it again with a different host while already bound leaves this panel registered as a stale listener on the previous host's engine; call unbind() first if rebinding.

Specified by:

bind in interface ISimulationControlPanel

Parameters:

host - the simulation host (non-null)

unbind

public void unbind()

Description copied from interface: ISimulationControlPanel

Release any current host binding.

Specified by:

unbind in interface ISimulationControlPanel

onStateChange

public void onStateChange(SimulationContext ctx,
 SimulationState from,
 SimulationState to,
 String reason)

Description copied from interface: SimulationListener

Called on every state transition.

Specified by:

onStateChange in interface SimulationListener

Parameters:

ctx - simulation context

from - previous state

to - new state

reason - human-readable reason (may be null)

onRun

public void onRun(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine begins execution (enters SimulationState.RUNNING).

Specified by:

onRun in interface SimulationListener

Parameters:

ctx - simulation context

onResume

public void onResume(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine resumes from SimulationState.PAUSED back to SimulationState.RUNNING.

Specified by:

onResume in interface SimulationListener

Parameters:

ctx - simulation context

onPause

public void onPause(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine enters SimulationState.PAUSED.

Specified by:

onPause in interface SimulationListener

Parameters:

ctx - simulation context

onDone

public void onDone(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine ends normally (reaches SimulationState.TERMINATED).

Specified by:

onDone in interface SimulationListener

Parameters:

ctx - simulation context

onFail

public void onFail(SimulationContext ctx,
 Throwable error)

Description copied from interface: SimulationListener

Called when the engine fails (reaches SimulationState.FAILED).

Specified by:

onFail in interface SimulationListener

Parameters:

ctx - simulation context

error - the exception/error that caused failure

onCancelRequested

public void onCancelRequested(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when cancellation is requested via SimulationEngine.requestCancel().

This callback occurs on the EDT; the simulation thread observes cancellation via SimulationContext.isCancelRequested().

Specified by:

onCancelRequested in interface SimulationListener

Parameters:

ctx - simulation context

onMessage

public void onMessage(SimulationContext ctx,
 String message)

Description copied from interface: SimulationListener

Called for status/log messages intended for UI display.

Specified by:

onMessage in interface SimulationListener

Parameters:

ctx - simulation context

message - message text (non-null)

onProgress

public void onProgress(SimulationContext ctx,
 ProgressInfo progress)

Description copied from interface: SimulationListener

Called for progress updates (indeterminate or determinate).

Specified by:

onProgress in interface SimulationListener

Parameters:

ctx - simulation context

progress - progress payload

onRefresh

public void onRefresh(SimulationContext ctx)

Description copied from interface: SimulationListener

Called for a graphics refresh/update event. Views typically repaint in response.

Specified by:

onRefresh in interface SimulationListener

Parameters:

ctx - simulation context

simplifiedPanel

public static IconSimulationControlPanel simplifiedPanel(boolean includeStartButton)