Package jmri.jmrit

Class DccLocoAddressSelector

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

jmri.jmrit.DccLocoAddressSelector

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class DccLocoAddressSelector
extends JPanel

Tool for selecting short/long address for DCC throttles. This is made more complex because we want it to appear easier. Some DCC systems allow addresses like 112 to be either long (extended) or short; others default to one or the other.

When locked (the default), the short/long selection is forced to stay in synch with what's available from the current ThrottleManager. If unlocked, this can differ if it's been explicity specified via the GUI (e.g. you can call 63 a long address even if the DCC system can't actually do it right now). This is useful in decoder programming, for example, where you might be configuring a loco to run somewhere else.

See Also:

• Serialized Form

Nested Class Summary

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

Modifier and Type	Field	Description
(package private) JComboBox<String>	box
(package private) boolean	followingAnotherSelector
(package private) static final ResourceBundle	rb
(package private) JTextField	text
(package private) boolean	varFontSize

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
DccLocoAddressSelector()
DccLocoAddressSelector(String[] protocols)

Method Summary

Modifier and Type	Method	Description
void	addKeyListener(KeyListener l)
void	followAnotherSelector(DccLocoAddressSelector selector)	This Selector's protocol box will follow another DccLocoAddressSelector's selected protocol, so this one's protocol choice is constrained to match.
DccLocoAddress	getAddress()	Get the currently selected DCC address.
JPanel	getCombinedJPanel()	Get a JPanel containing the combined selector.
boolean	getLocked(boolean l)
JComboBox<String>	getSelector()	Get the selector box for picking long/short as a separate component.
JTextField	getTextField()	Get the text field for entering the number as a separate component.
(package private) void	reportError(String msg)
void	reset()	Put back to original state, clearing GUI
void	setAddress(DccLocoAddress a)
void	setEnabled(boolean e)	Provide a common setEnable call for the GUI components in the selector
void	setEnabledProtocol(boolean e)
void	setLocked(boolean l)
void	setVariableSize(boolean s)

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, 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, 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

Field Details

box

JComboBox<String> box

text

JTextField text

varFontSize

boolean varFontSize

followingAnotherSelector

boolean followingAnotherSelector

rb

static final ResourceBundle rb

Constructor Details

DccLocoAddressSelector

public DccLocoAddressSelector()

DccLocoAddressSelector

public DccLocoAddressSelector(String[] protocols)

Method Details

setLocked

public void setLocked(boolean l)

getLocked

public boolean getLocked(boolean l)

getAddress

public DccLocoAddress getAddress()

Get the currently selected DCC address.

This is the primary output of this class.

Returns:

DccLocoAddress object containing GUI choices, or null if no entries in GUI

setAddress

public void setAddress(DccLocoAddress a)

setVariableSize

public void setVariableSize(boolean s)

reset

public void reset()

Put back to original state, clearing GUI

getCombinedJPanel

public JPanel getCombinedJPanel()

Get a JPanel containing the combined selector.

Because Swing only allows a component to be inserted in one container, this can only be done once

setEnabled

public void setEnabled(boolean e)

Provide a common setEnable call for the GUI components in the selector

Overrides:

setEnabled in class JComponent

setEnabledProtocol

public void setEnabledProtocol(boolean e)

getTextField

public JTextField getTextField()

Get the text field for entering the number as a separate component.

Because Swing only allows a component to be inserted in one container, this can only be done once

reportError

void reportError(String msg)

getSelector

public JComboBox<String> getSelector()

Get the selector box for picking long/short as a separate component. Because Swing only allows a component to be inserted in one container, this can only be done once

followAnotherSelector

public void followAnotherSelector(DccLocoAddressSelector selector)

This Selector's protocol box will follow another DccLocoAddressSelector's selected protocol, so this one's protocol choice is constrained to match. At present, this can't be undone. Meant for use in e.g. the consist tool for protocols that require only one type of protocol in a consist

addKeyListener

public void addKeyListener(KeyListener l)

Overrides:

addKeyListener in class Component