Package jmri.jmrit.symbolicprog
Class EnumVariableValue
- java.lang.Object
-
- jmri.jmrit.symbolicprog.AbstractValue
-
- jmri.jmrit.symbolicprog.VariableValue
-
- jmri.jmrit.symbolicprog.EnumVariableValue
-
- All Implemented Interfaces:
java.awt.event.ActionListener,java.beans.PropertyChangeListener,java.util.EventListener
- Direct Known Subclasses:
CompositeVariableValue
public class EnumVariableValue extends VariableValue implements java.awt.event.ActionListener
Extends VariableValue to represent an enumerated variable.- See Also:
VariableValue
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description (package private) static classEnumVariableValue.TreeLeafNodestatic classEnumVariableValue.VarComboBox-
Nested classes/interfaces inherited from class jmri.jmrit.symbolicprog.AbstractValue
AbstractValue.ValueState
-
-
Field Summary
Fields Modifier and Type Field Description (package private) java.awt.Color_defaultColor(package private) int_maxVal(package private) int_minVal(package private) javax.swing.JComboBox<java.lang.String>_value(package private) java.util.Deque<javax.swing.tree.DefaultMutableTreeNode>treeNodes-
Fields inherited from class jmri.jmrit.symbolicprog.VariableValue
_cvMap, _status, _tooltipText
-
Fields inherited from class jmri.jmrit.symbolicprog.AbstractValue
prop
-
-
Constructor Summary
Constructors Constructor Description EnumVariableValue()Create a null object.EnumVariableValue(java.lang.String name, java.lang.String comment, java.lang.String cvName, boolean readOnly, boolean infoOnly, boolean writeOnly, boolean opsOnly, java.lang.String cvNum, java.lang.String mask, int minVal, int maxVal, java.util.HashMap<java.lang.String,CvValue> v, javax.swing.JLabel status, java.lang.String stdname)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidactionPerformed(java.awt.event.ActionEvent e)voidaddItem(java.lang.String s)Create a new item in the enumeration, with an associated value one more than the last item (or zero if this is the first one added)voidaddItem(java.lang.String s, int value)Create a new item in the enumeration, with a specified associated value.voiddispose()Dispose of the object.(package private) voiddisposeReps()voidendGroup()java.awt.ComponentgetCommonRep()Get a display representationObjectof this variable.intgetIntValue()Get the value as a single integer.java.awt.ComponentgetNewRep(java.lang.String format)Creates a newObjectrepresentation for display purposes, using the specified format.java.lang.StringgetTextValue()java.lang.ObjectgetValueObject()java.lang.StringgetValueString()booleanisChanged()Determine whether this Variable is "changed", so that "read changes" and "write changes" will act on it.voidlastItem()voidnItems(int n)voidpropertyChange(java.beans.PropertyChangeEvent e)java.lang.ObjectrangeVal()Gets a (usually text) description of the variable type and range.voidreadAll()Always read the contents of this Variable.voidreadChanges()Read the contents of this Variable if it's in a state that indicates it was "changed".protected voidselectValue(int value)Set to a specific value.voidsetAvailable(boolean a)Sets the availability status of the object.(package private) voidsetColor(java.awt.Color c)Method to handle color changes for states.voidsetCvState(AbstractValue.ValueState state)Notify the connected CVs of a state change from abovevoidsetIntValue(int i)Set the value from a single number.voidsetToolTipText(java.lang.String t)Set tooltip text to be used by both the "value" and representations of this Variable.voidsetValue(int value)voidstartGroup(java.lang.String name)CvValue[]usesCVs()Provide access to CVs used by this Variable.voidwriteAll()Always write the contents of this Variable.voidwriteChanges()Write the contents of this Variable if it's in a state that indicates it was "changed".-
Methods inherited from class jmri.jmrit.symbolicprog.VariableValue
confirmAll, considerChanged, cvName, getComment, getCvDescription, getCvName, getCvNum, getInfoOnly, getLongValue, getMask, getMaxMask, getOpsOnly, getReadOnly, getState, getValueInCV, getWriteOnly, isBitMask, isBusy, isToRead, isToWrite, item, label, maskValAsInt, offsetVal, setBusy, setState, setToRead, setToWrite, setValue, setValueInCV, simplifyMask, updatedTextField, updateRepresentation
-
Methods inherited from class jmri.jmrit.symbolicprog.AbstractValue
addPropertyChangeListener, getAvailable, removePropertyChangeListener
-
-
-
-
Field Detail
-
_value
javax.swing.JComboBox<java.lang.String> _value
-
treeNodes
java.util.Deque<javax.swing.tree.DefaultMutableTreeNode> treeNodes
-
_maxVal
int _maxVal
-
_minVal
int _minVal
-
_defaultColor
java.awt.Color _defaultColor
-
-
Constructor Detail
-
EnumVariableValue
public EnumVariableValue(java.lang.String name, java.lang.String comment, java.lang.String cvName, boolean readOnly, boolean infoOnly, boolean writeOnly, boolean opsOnly, java.lang.String cvNum, java.lang.String mask, int minVal, int maxVal, java.util.HashMap<java.lang.String,CvValue> v, javax.swing.JLabel status, java.lang.String stdname)
-
EnumVariableValue
public EnumVariableValue()
Create a null object. Normally only used for tests and to pre-load classes.
-
-
Method Detail
-
usesCVs
public CvValue[] usesCVs()
Description copied from class:VariableValueProvide access to CVs used by this Variable.- Specified by:
usesCVsin classVariableValue- Returns:
- an array of CVs used by this Variable
-
nItems
public void nItems(int n)
-
addItem
public void addItem(java.lang.String s)
Create a new item in the enumeration, with an associated value one more than the last item (or zero if this is the first one added)- Parameters:
s- Name of the enumeration item
-
addItem
public void addItem(java.lang.String s, int value)
Create a new item in the enumeration, with a specified associated value.- Parameters:
s- Name of the enumeration itemvalue- item value.
-
startGroup
public void startGroup(java.lang.String name)
-
endGroup
public void endGroup()
-
lastItem
public void lastItem()
-
setToolTipText
public void setToolTipText(java.lang.String t)
Description copied from class:VariableValueSet tooltip text to be used by both the "value" and representations of this Variable.This is expected to be overridden in subclasses to change their internal info.
- Overrides:
setToolTipTextin classVariableValue- Parameters:
t- the tooltip text to be used- See Also:
VariableValue.updateRepresentation(javax.swing.JComponent)
-
setAvailable
public void setAvailable(boolean a)
Description copied from class:AbstractValueSets the availability status of the object.- Overrides:
setAvailablein classAbstractValue- Parameters:
a-trueif the object should be made available,falseif should be made unavailable
-
rangeVal
public java.lang.Object rangeVal()
Description copied from class:VariableValueGets a (usually text) description of the variable type and range.- Specified by:
rangeValin classVariableValue- Returns:
- description of the variable type and range
-
actionPerformed
public void actionPerformed(java.awt.event.ActionEvent e)
- Specified by:
actionPerformedin interfacejava.awt.event.ActionListener
-
getValueString
public java.lang.String getValueString()
- Specified by:
getValueStringin classVariableValue- Returns:
- String that can (usually) be interpreted as an integer
-
setIntValue
public void setIntValue(int i)
Description copied from class:VariableValueSet the value from a single number.In some cases, e.g. speed tables, this will result in complex behavior, where setIntValue(getIntValue()) results in something unexpected.
- Specified by:
setIntValuein classVariableValue- Parameters:
i- the integer value to set
-
getTextValue
public java.lang.String getTextValue()
- Overrides:
getTextValuein classVariableValue- Returns:
- User-desired value, which may or may not be an integer
-
getValueObject
public java.lang.Object getValueObject()
- Specified by:
getValueObjectin classVariableValue- Returns:
- Value as a native-form Object
-
selectValue
protected void selectValue(int value)
Set to a specific value.This searches for the displayed value, and sets the enum to that particular one. It used to work off an index, but now it looks for the value.
If the value is larger than any defined, a new one is created.
- Parameters:
value- What to set to.
-
getIntValue
public int getIntValue()
Description copied from class:VariableValueGet the value as a single integer.In some cases, e.g. speed tables, this will result in complex behavior, where setIntValue(getIntValue()) results in something unexpected.
- Specified by:
getIntValuein classVariableValue- Returns:
- the value as an integer
-
getCommonRep
public java.awt.Component getCommonRep()
Description copied from class:VariableValueGet a display representationObjectof this variable.
The actual stored value of a variable is not the most interesting thing. Instead, you usually get anObjectrepresentation for display in a table, etc. Modification of the state of that object then gets reflected back, causing the underlying CV objects to change.- Specified by:
getCommonRepin classVariableValue- Returns:
- the
Objectrepresentation for display purposes
-
setValue
public void setValue(int value)
-
getNewRep
public java.awt.Component getNewRep(java.lang.String format)
Description copied from class:VariableValueCreates a newObjectrepresentation for display purposes, using the specified format.- Specified by:
getNewRepin classVariableValue- Parameters:
format- a name representing- Returns:
- an
Objectrepresentation for display purposes
-
setColor
void setColor(java.awt.Color c)
Description copied from class:AbstractValueMethod to handle color changes for states.- Specified by:
setColorin classAbstractValue- Parameters:
c- the desired colour
-
setCvState
public void setCvState(AbstractValue.ValueState state)
Notify the connected CVs of a state change from above- Specified by:
setCvStatein classVariableValue- Parameters:
state- the new state to set
-
isChanged
public boolean isChanged()
Description copied from class:VariableValueDetermine whether this Variable is "changed", so that "read changes" and "write changes" will act on it.- Specified by:
isChangedin classVariableValue- Returns:
- true if Variable is "changed"
- See Also:
VariableValue.considerChanged(jmri.jmrit.symbolicprog.CvValue)
-
readChanges
public void readChanges()
Description copied from class:VariableValueRead the contents of this Variable if it's in a state that indicates it was "changed".- Specified by:
readChangesin classVariableValue- See Also:
VariableValue.isChanged()
-
writeChanges
public void writeChanges()
Description copied from class:VariableValueWrite the contents of this Variable if it's in a state that indicates it was "changed".- Specified by:
writeChangesin classVariableValue- See Also:
VariableValue.isChanged()
-
readAll
public void readAll()
Description copied from class:VariableValueAlways read the contents of this Variable.- Specified by:
readAllin classVariableValue
-
writeAll
public void writeAll()
Description copied from class:VariableValueAlways write the contents of this Variable.- Specified by:
writeAllin classVariableValue
-
propertyChange
public void propertyChange(java.beans.PropertyChangeEvent e)
- Specified by:
propertyChangein interfacejava.beans.PropertyChangeListener- Specified by:
propertyChangein classVariableValue
-
dispose
public void dispose()
Description copied from class:VariableValueDispose of the object.- Specified by:
disposein classVariableValue
-
disposeReps
void disposeReps()
-
-