ptolemy.actor.parameters
Class IntRangeParameter
java.lang.Object
ptolemy.kernel.util.NamedObj
ptolemy.kernel.util.Attribute
ptolemy.kernel.util.AbstractSettableAttribute
ptolemy.data.expr.Variable
ptolemy.data.expr.Parameter
ptolemy.actor.parameters.IntRangeParameter
- All Implemented Interfaces:
- Changeable, java.lang.Cloneable, Debuggable, DebugListener, Derivable, HasTypeConstraints, ModelErrorHandler, MoMLExportable, Nameable, java.io.Serializable, Settable, Typeable, ValueListener
- public class IntRangeParameter
- extends Parameter
This is a parameter with type integer with a limited range.
Its value is an integer token that is constrained to lie
within the boundaries specified by its two parameters,
min and max. These specify the minimum and maximum values.
A user interface will typically use this
information to represent the parameter value using a slider.
The default values for min and max are 0 and 100,
respectively, and the default value for this parameter is 50.
- Since:
- Ptolemy II 3.0
- Version:
- $Id: IntRangeParameter.java,v 1.8 2004/04/13 03:10:43 cxh Exp $
- Author:
- Edward A. Lee
- See Also:
- Serialized Form
- Accepted Rating:
- Proposed Rating:
| Fields inherited from class ptolemy.kernel.util.NamedObj |
_changeListeners, _changeLock, _changeRequests, _debugging, _debugListeners, _elementName, _isPersistent, _workspace, ATTRIBUTES, CLASSNAME, COMPLETE, CONTENTS, DEEP, FULLNAME, LINKS |
|
Constructor Summary |
IntRangeParameter(NamedObj container,
java.lang.String name)
Construct an attribute with the given name contained by the
specified container. |
|
Method Summary |
protected void |
_setTokenAndNotify(Token newToken)
|
void |
attributeChanged(Attribute attribute)
React to a change in an attribute by ensuring that the current
value remains within the range given by min and max. |
int |
getCurrentValue()
Return the current value of this parameter as an integer. |
int |
getMaxValue()
Return the maximum value of this parameter as an integer. |
int |
getMinValue()
Return the minimum value of this parameter. |
| Methods inherited from class ptolemy.data.expr.Variable |
_description, _evaluate, _notifyValueListeners, _parseIfNecessary, _propagate, _propagateToValueListeners, _propagateValue, _setToken, addValueListener, clone, getDeclaredType, getExpression, getFreeIdentifiers, getScope, getToken, getType, getTypeTerm, getVisibility, invalidate, isKnown, isLazy, isStringMode, isTypeAcceptable, removeValueListener, reset, setContainer, setExpression, setLazy, setParseTreeEvaluator, setStringMode, setToken, setToken, setTypeAtLeast, setTypeAtLeast, setTypeAtMost, setTypeEquals, setTypeSameAs, setUnknown, setVisibility, stringRepresentation, toString, typeConstraintList, validate, valueChanged |
| Methods inherited from class ptolemy.kernel.util.NamedObj |
_addAttribute, _attachText, _cloneFixAttributeFields, _debug, _debug, _debug, _debug, _debug, _exportMoMLContents, _getIndentPrefix, _isMoMLSuppressed, _markContentsDerived, _removeAttribute, _splitName, _stripNumericSuffix, addChangeListener, addDebugListener, attributeList, attributeList, attributeTypeChanged, clone, containedObjectsIterator, deepContains, depthInHierarchy, description, description, event, executeChangeRequests, exportMoML, exportMoML, exportMoML, exportMoML, getAttribute, getAttribute, getAttributes, getChangeListeners, getClassName, getDerivedLevel, getDerivedList, getElementName, getFullName, getModelErrorHandler, getName, getName, getPrototypeList, getSource, handleModelError, isDeferringChangeRequests, isOverridden, isPersistent, message, propagateExistence, propagateValue, propagateValues, removeChangeListener, removeDebugListener, requestChange, setClassName, setDeferringChangeRequests, setDerivedLevel, setModelErrorHandler, setPersistent, setSource, toplevel, uniqueName, validateSettables, workspace |
| Methods inherited from class java.lang.Object |
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
max
public Parameter max
- The maximum value. This is has an integer value, and defaults to 100.
min
public Parameter min
- The minimum value. This is has an integer value, and defaults to 0.
IntRangeParameter
public IntRangeParameter(NamedObj container,
java.lang.String name)
throws IllegalActionException,
NameDuplicationException
- Construct an attribute with the given name contained by the
specified container. The container argument must not be null, or a
NullPointerException will be thrown. This attribute will use the
workspace of the container for synchronization and version counts.
If the name argument is null, then the name is set to the empty
string. Increment the version of the workspace.
- Parameters:
container - The container.name - The name of this attribute.
- Throws:
IllegalActionException - If the attribute is not of an
acceptable class for the container, or if the name contains a period.
NameDuplicationException - If the name coincides with
an attribute already in the container.
attributeChanged
public void attributeChanged(Attribute attribute)
throws IllegalActionException
- React to a change in an attribute by ensuring that the current
value remains within the range given by min and max.
- Overrides:
attributeChanged in class NamedObj
- Parameters:
attribute - The attribute that changed.
- Throws:
IllegalActionException - If the change is not acceptable
to this container (should not be thrown).
getCurrentValue
public int getCurrentValue()
throws IllegalActionException
- Return the current value of this parameter as an integer.
- Returns:
- The current value.
- Throws:
IllegalActionException - If the expression cannot
be parsed or cannot be evaluated, or if the result of evaluation
violates type constraints, or if the result of evaluation is null
and there are variables that depend on this one.
getMaxValue
public int getMaxValue()
throws IllegalActionException
- Return the maximum value of this parameter as an integer.
- Returns:
- The maximum value.
- Throws:
IllegalActionException - If the expression cannot
be parsed or cannot be evaluated, or if the result of evaluation
violates type constraints, or if the result of evaluation is null
and there are variables that depend on this one.
getMinValue
public int getMinValue()
throws IllegalActionException
- Return the minimum value of this parameter.
- Returns:
- The minimum value.
- Throws:
IllegalActionException - If the expression cannot
be parsed or cannot be evaluated, or if the result of evaluation
violates type constraints, or if the result of evaluation is null
and there are variables that depend on this one.
_setTokenAndNotify
protected void _setTokenAndNotify(Token newToken)
throws IllegalActionException
- Overrides:
_setTokenAndNotify in class Variable
- Throws:
IllegalActionException