jmri.jmrit.symbolicprog.tabbedframe
Class PaneProgFrame

Show UML class diagram

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame
                  javax.swing.JFrame
                      jmri.util.JmriJFrame
                          jmri.jmrit.symbolicprog.tabbedframe.PaneProgFrame

All Implemented Interfaces:

ComponentListener, WindowListener, ImageObserver, MenuContainer, PropertyChangeListener, Serializable, EventListener, Accessible, RootPaneContainer, WindowConstants, BeanInterface, PaneContainer, ModifiedFlag, WindowInterface

Direct Known Subclasses:

PaneOpsProgFrame, PaneServiceProgFrame

public abstract class PaneProgFrame
extends JmriJFrame
implements PropertyChangeListener, PaneContainer

Frame providing a command station programmer from decoder definition files.

See Also:

Serialized Form

Nested Class Summary

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

JFrame.AccessibleJFrame

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

Frame.AccessibleAWTFrame

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

Window.AccessibleAWTWindow

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

Nested classes/interfaces inherited from interface jmri.util.swing.WindowInterface

WindowInterface.Hint

Field Summary

(package private) FunctionLabelPane	_flPane
(package private) boolean	_opsMode
(package private) PaneProgPane	_programmingPane
(package private) boolean	_read
(package private) RosterMediaPane	_rMPane
(package private) RosterEntry	_rosterEntry
(package private) RosterEntryPane	_rPane
(package private) List<JComponent>	activeComponents
(package private) VariableValue	addMode
(package private) CvTableModel	cvModel
(package private) ShutDownTask	decoderDirtyTask
(package private) org.jdom.Element	decoderRoot
(package private) int[]	defaultCvNumbers
(package private) int[]	defaultCvValues
(package private) int[]	defaultIndexedCvValues
(package private) VariableValue	extendAddr
(package private) ShutDownTask	fileDirtyTask
(package private) String	filename
(package private) BusyGlassPane	glassPane
(package private) IndexedCvTableModel	iCvModel
(package private) boolean	justChanges
(package private) ItemListener	l1
(package private) ItemListener	l2
(package private) ItemListener	l3
(package private) ItemListener	l4
(package private) static org.slf4j.Logger	log
(package private) org.jdom.Element	modelElem Data element holding the 'model' element representing the decoder type
(package private) JPanel	modePane
(package private) Programmer	mProgrammer
(package private) List<JPanel>	paneList
(package private) int	paneListIndex
(package private) VariableValue	primaryAddr
(package private) org.jdom.Element	programmerRoot
(package private) JLabel	progStatus
(package private) JToggleButton	readAllButton
(package private) JToggleButton	readChangesButton
(package private) JMenu	resetMenu
(package private) ResetTableModel	resetModel
(package private) static boolean	showEmptyPanes
(package private) JTabbedPane	tabPane
(package private) VariableTableModel	variableModel
(package private) JToggleButton	writeAllButton
(package private) JToggleButton	writeChangesButton

Fields inherited from class jmri.util.JmriJFrame

allowInFrameServlet, properties, reuseFrameSavedPosition, reuseFrameSavedSized, windowInterface

Fields inherited from class javax.swing.JFrame

accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

PaneProgFrame(DecoderFile pDecoderFile, RosterEntry pRosterEntry, String pFrameTitle, String pProgrammerFile, Programmer pProg, boolean opsMode)
Initialization sequence: Ask the RosterEntry to read its contents If the decoder file is specified, open and load it, otherwise get the decoder filename from the RosterEntry and load that.

Method Summary

(package private) void	addHelp()
protected boolean	checkDirtyDecoder()
protected boolean	checkDirtyFile()
void	dispose() local dispose, which also invokes parent.
(package private) boolean	doRead()
(package private) boolean	doWrite()
void	enableButtons(boolean stat) Enable the read/write buttons.
(package private) void	enableReadButtons() Enable the read all and read changes button if possible.
BusyGlassPane	getBusyGlassPane()
Dimension	getMaximumSize() Provide a maximum frame size that is limited to what can fit on the screen after toolbars, etc are deducted.
protected abstract JPanel	getModePane() Abstract method to provide a JPanel setting the programming mode, if appropriate.
List<JPanel>	getPaneList()
Dimension	getPreferredSize() The preferred size must fit on the physical screen, so calculate the lesser of either the preferred size from the layout or the screen size.
RosterEntry	getRosterEntry()
static boolean	getShowEmptyPanes()
protected void	handleDirtyFile()
protected void	installComponents()
boolean	isBusy()
protected void	loadDecoderFile(DecoderFile df, RosterEntry re)
protected void	loadDecoderFromLoco(RosterEntry r)
protected void	loadProgrammerFile(RosterEntry r)
protected JPanel	makeFunctionLabelPane(RosterEntry r)
protected JPanel	makeInfoPane(RosterEntry r)
protected JPanel	makeMediaPane(RosterEntry r)
void	newPane(String name, org.jdom.Element pane, org.jdom.Element modelElem, boolean enableEmpty)
void	paneFinished()
void	prepGlassPane(AbstractButton activeButton)
void	printPanes(boolean preview)
void	propertyChange(PropertyChangeEvent e) get notification of a variable property change in the pane, specifically "busy" going to false at the end of a programming operation
boolean	readAll() invoked by "Read All" button, this sets in motion a continuing sequence of "read all" operations on the panes.
boolean	readChanges() invoked by "Read Changes" button, this sets in motion a continuing sequence of "read changes" operations on the panes.
(package private) void	readConfig(org.jdom.Element root, RosterEntry r)
protected void	resetToDefaults() reset all CV values to defaults stored earlier.
protected void	saveDefaults() Save all CV values.
static void	setShowEmptyPanes(boolean yes) Option to control appearance of empty panes
boolean	storeFile() Store the locomotives information in the roster (and a RosterEntry file).
(package private) void	updateDccAddress()
void	windowClosing(WindowEvent e) Close box has been clicked; handle check for dirty with respect to decoder or file, then close.
boolean	writeAll() invoked by "Write All" button, this sets in motion a continuing sequence of "write all" operations on each pane.
boolean	writeChanges() invoked by "Write Changes" button, this sets in motion a continuing sequence of "write changes" operations on each pane.

Methods inherited from class jmri.util.JmriJFrame

addHelpMenu, addNotify, componentHidden, componentMoved, componentResized, componentShown, generateWindowRef, getAllowInFrameServlet, getEscapeKeyAction, getEscapeKeyClosesWindow, getFrame, getFrame, getFrameList, getFrameList, getIndexedProperty, getModifiedFlag, getProperty, getPropertyNames, getSavePosition, getSaveSize, getWindowFrameRef, getWindowInterface, handleModified, hasProperty, initComponents, makePrivateWindow, markWindowModified, multipleInstances, pack, setAllowInFrameServlet, setEscapeKeyAction, setEscapeKeyClosesWindow, setIndexedProperty, setModifiedFlag, setProperty, setSavePosition, setSaveSize, setShutDownTask, setWindowInterface, show, show, storeValues, windowActivated, windowClosed, windowDeactivated, windowDeiconified, windowIconified, windowOpened

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame

getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setVisible, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMinimumSize, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Detail

progStatus

JLabel progStatus

cvModel

CvTableModel cvModel

iCvModel

IndexedCvTableModel iCvModel

variableModel

VariableTableModel variableModel

resetModel

ResetTableModel resetModel

resetMenu

JMenu resetMenu

mProgrammer

Programmer mProgrammer

modePane

JPanel modePane

_opsMode

boolean _opsMode

_rosterEntry

RosterEntry _rosterEntry

_rPane

RosterEntryPane _rPane

_flPane

FunctionLabelPane _flPane

_rMPane

RosterMediaPane _rMPane

paneList

List<JPanel> paneList

paneListIndex

int paneListIndex

glassPane

BusyGlassPane glassPane

activeComponents

List<JComponent> activeComponents

filename

String filename

tabPane

JTabbedPane tabPane

readChangesButton

JToggleButton readChangesButton

writeChangesButton

JToggleButton writeChangesButton

readAllButton

JToggleButton readAllButton

writeAllButton

JToggleButton writeAllButton

l1

ItemListener l1

l2

ItemListener l2

l3

ItemListener l3

l4

ItemListener l4

decoderDirtyTask

ShutDownTask decoderDirtyTask

fileDirtyTask

ShutDownTask fileDirtyTask

modelElem

org.jdom.Element modelElem

Data element holding the 'model' element representing the decoder type

decoderRoot

org.jdom.Element decoderRoot

programmerRoot

org.jdom.Element programmerRoot

defaultCvValues

int[] defaultCvValues

defaultCvNumbers

int[] defaultCvNumbers

defaultIndexedCvValues

int[] defaultIndexedCvValues

primaryAddr

VariableValue primaryAddr

extendAddr

VariableValue extendAddr

addMode

VariableValue addMode

justChanges

boolean justChanges

_read

boolean _read

_programmingPane

PaneProgPane _programmingPane

showEmptyPanes

static boolean showEmptyPanes

log

static org.slf4j.Logger log

Constructor Detail

PaneProgFrame

public PaneProgFrame(DecoderFile pDecoderFile,
                     RosterEntry pRosterEntry,
                     String pFrameTitle,
                     String pProgrammerFile,
                     Programmer pProg,
                     boolean opsMode)

Initialization sequence:

• Ask the RosterEntry to read its contents
• If the decoder file is specified, open and load it, otherwise get the decoder filename from the RosterEntry and load that. Note that we're assuming the roster entry has the right decoder, at least w.r.t. the loco file.
• Fill CV values from the roster entry
• Create the programmer panes

Parameters:

pDecoderFile - XML file defining the decoder contents

pRosterEntry - RosterEntry for information on this locomotive

pFrameTitle - Name/title for the frame

pProgrammerFile - Name of the programmer file to use

pProg - Programmer object to be used to access CVs

Method Detail

getModePane

protected abstract JPanel getModePane()

Abstract method to provide a JPanel setting the programming mode, if appropriate. A null value is ignored.

installComponents

protected void installComponents()

getPaneList

public List<JPanel> getPaneList()

addHelp

void addHelp()

getPreferredSize

public Dimension getPreferredSize()

Description copied from class: JmriJFrame

The preferred size must fit on the physical screen, so calculate the lesser of either the preferred size from the layout or the screen size.

Overrides:

getPreferredSize in class JmriJFrame

getMaximumSize

public Dimension getMaximumSize()

Description copied from class: JmriJFrame

Provide a maximum frame size that is limited to what can fit on the screen after toolbars, etc are deducted.

Some of the methods used here return null pointers on some Java implementations, however, so this will return the superclasses's maximum size if the algorithm used here fails.

Overrides:

getMaximumSize in class JmriJFrame

enableReadButtons

void enableReadButtons()

Enable the read all and read changes button if possible. This checks to make sure this is appropriate, given the attached programmer's capability.

loadDecoderFromLoco

protected void loadDecoderFromLoco(RosterEntry r)

loadDecoderFile

protected void loadDecoderFile(DecoderFile df,
                               RosterEntry re)

loadProgrammerFile

protected void loadProgrammerFile(RosterEntry r)

checkDirtyDecoder

protected boolean checkDirtyDecoder()

Returns:

true if decoder needs to be written

checkDirtyFile

protected boolean checkDirtyFile()

Returns:

true if file needs to be written

handleDirtyFile

protected void handleDirtyFile()

windowClosing

public void windowClosing(WindowEvent e)

Close box has been clicked; handle check for dirty with respect to decoder or file, then close.

Specified by:

windowClosing in interface WindowListener

Overrides:

windowClosing in class JmriJFrame

Parameters:

e - Not used

readConfig

void readConfig(org.jdom.Element root,
                RosterEntry r)

resetToDefaults

protected void resetToDefaults()

reset all CV values to defaults stored earlier. This will in turn update the variables

saveDefaults

protected void saveDefaults()

Save all CV values. These stored values are used by resetToDefaults

makeInfoPane

protected JPanel makeInfoPane(RosterEntry r)

makeFunctionLabelPane

protected JPanel makeFunctionLabelPane(RosterEntry r)

makeMediaPane

protected JPanel makeMediaPane(RosterEntry r)

updateDccAddress

void updateDccAddress()

newPane

public void newPane(String name,
                    org.jdom.Element pane,
                    org.jdom.Element modelElem,
                    boolean enableEmpty)

getBusyGlassPane

public BusyGlassPane getBusyGlassPane()

Specified by:

getBusyGlassPane in interface PaneContainer

prepGlassPane

public void prepGlassPane(AbstractButton activeButton)

Specified by:

prepGlassPane in interface PaneContainer

paneFinished

public void paneFinished()

Specified by:

paneFinished in interface PaneContainer

enableButtons

public void enableButtons(boolean stat)

Enable the read/write buttons.

In addition, if a programming mode pane is present, it's "set" button is enabled.

Specified by:

enableButtons in interface PaneContainer

Parameters:

stat - Are reads possible? If false, so not enable the read buttons.

isBusy

public boolean isBusy()

Specified by:

isBusy in interface PaneContainer

readChanges

public boolean readChanges()

invoked by "Read Changes" button, this sets in motion a continuing sequence of "read changes" operations on the panes. Each invocation of this method reads one pane; completion of that request will cause it to happen again, reading the next pane, until there's nothing left to read.

Returns:

true if a read has been started, false if the operation is complete.

readAll

public boolean readAll()

invoked by "Read All" button, this sets in motion a continuing sequence of "read all" operations on the panes. Each invocation of this method reads one pane; completion of that request will cause it to happen again, reading the next pane, until there's nothing left to read.

Returns:

true if a read has been started, false if the operation is complete.

doRead

boolean doRead()

writeAll

public boolean writeAll()

invoked by "Write All" button, this sets in motion a continuing sequence of "write all" operations on each pane. Each invocation of this method writes one pane; completion of that request will cause it to happen again, writing the next pane, until there's nothing left to write.

Returns:

true if a write has been started, false if the operation is complete.

writeChanges

public boolean writeChanges()

invoked by "Write Changes" button, this sets in motion a continuing sequence of "write changes" operations on each pane. Each invocation of this method writes one pane; completion of that request will cause it to happen again, writing the next pane, until there's nothing left to write.

Returns:

true if a write has been started, false if the operation is complete.

doWrite

boolean doWrite()

printPanes

public void printPanes(boolean preview)

propertyChange

public void propertyChange(PropertyChangeEvent e)

get notification of a variable property change in the pane, specifically "busy" going to false at the end of a programming operation

Specified by:

propertyChange in interface PropertyChangeListener

Parameters:

e - Event, used to find source

storeFile

public boolean storeFile()

Store the locomotives information in the roster (and a RosterEntry file).

Returns:

false if store failed

dispose

public void dispose()

local dispose, which also invokes parent. Note that we remove the components (removeAll) before taking those apart.

Specified by:

dispose in interface WindowInterface

Overrides:

dispose in class JmriJFrame

setShowEmptyPanes

public static void setShowEmptyPanes(boolean yes)

Option to control appearance of empty panes

getShowEmptyPanes

public static boolean getShowEmptyPanes()

getRosterEntry

public RosterEntry getRosterEntry()