Package ptolemy.actor.gui

Class MatrixTokenTableau

java.lang.Object

ptolemy.kernel.util.NamedObj

ptolemy.kernel.InstantiableNamedObj

ptolemy.kernel.Entity<T>

ptolemy.kernel.ComponentEntity

ptolemy.kernel.CompositeEntity

ptolemy.actor.gui.Tableau

ptolemy.actor.gui.TokenTableau

ptolemy.actor.gui.MatrixTokenTableau

All Implemented Interfaces:

java.lang.Cloneable, Changeable, Debuggable, DebugListener, Derivable, Instantiable, ModelErrorHandler, MoMLExportable, Moveable, Nameable

public class MatrixTokenTableau
extends TokenTableau

A tableau representing matrix tokens in a top-level window with a table. This should be constructed using the provided factory, to ensure that the matrix pane is created.

Since:

Ptolemy II 2.1

Version:

$Id$

Author:

Edward A. Lee

See Also:

TokenEffigy

Pt.AcceptedRating:

Red (cxh)

Pt.ProposedRating:

Yellow (eal)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MatrixTokenTableau.Factory	A factory that creates a matrix token tableau.

Nested classes/interfaces inherited from class ptolemy.kernel.CompositeEntity

CompositeEntity.ContainedObjectsIterator

Field Summary

Fields inherited from class ptolemy.actor.gui.Tableau

_debugClosing, size

Fields inherited from class ptolemy.kernel.CompositeEntity

_levelCrossingLinks

Fields inherited from class ptolemy.kernel.util.NamedObj

_changeListeners, _changeLock, _changeRequests, _debugging, _debugListeners, _deferChangeRequests, _elementName, _isPersistent, _verbose, _workspace, ATTRIBUTES, CLASSNAME, COMPLETE, CONTENTS, DEEP, FULLNAME, LINKS

Constructor Summary

Constructors

Constructor	Description
MatrixTokenTableau(Effigy container, java.lang.String name)	Construct a new tableau for the model represented by the given effigy.
MatrixTokenTableau(Effigy container, java.lang.String name, TableauFrame frame)	Construct a new tableau for the model represented by the given effigy, using the specified frame.

Method Summary

Modifier and Type	Method	Description
void	append(java.util.List list)	Display the specified tokens.
void	append(Token token)	Display the specified token.
static boolean	canDisplay(Token token)	Return true if this tableau can display the specified token.
void	clear()	Clear the display.
void	createFrame(TableauFrame frame)	Create a matrix frame to view the data.

Methods inherited from class ptolemy.actor.gui.Tableau

attributeChanged, clone, close, getFrame, getTitle, isEditable, isMaster, setContainer, setEditable, setFrame, setMaster, setTitle, show

Methods inherited from class ptolemy.kernel.CompositeEntity

_addEntity, _addRelation, _adjustDeferrals, _containedDecorators, _deepOpaqueEntityList, _description, _exportMoMLContents, _finishedAddEntity, _removeEntity, _removeRelation, _validateSettables, allAtomicEntityList, allowLevelCrossingConnect, classDefinitionList, connect, connect, containedObjectsIterator, deepCompositeEntityList, deepEntityList, deepGetEntities, deepNamedObjList, deepOpaqueEntityList, deepRelationSet, entityList, entityList, exportLinks, exportMoML, getAttribute, getEntities, getEntity, getPort, getRelation, getRelations, isAtomic, isOpaque, lazyAllAtomicEntityList, lazyAllCompositeEntityList, lazyAllCompositeTransparentAndOpaqueEntityList, lazyClassDefinitionList, lazyDeepEntityList, lazyEntityList, lazyRelationList, newRelation, numberOfEntities, numberOfRelations, numEntities, numRelations, relationList, removeAllEntities, removeAllRelations, setClassDefinition, statistics, uniqueName

Methods inherited from class ptolemy.kernel.ComponentEntity

_checkContainer, _getContainedObject, _propagateExistence, getContainer, instantiate, moveDown, moveToFirst, moveToIndex, moveToLast, moveUp, newPort, propagateExistence, setName

Methods inherited from class ptolemy.kernel.Entity

_addPort, _removePort, connectedPortList, connectedPorts, connectionsChanged, getPorts, linkedRelationList, linkedRelations, portList, removeAllPorts

Methods inherited from class ptolemy.kernel.InstantiableNamedObj

_setParent, getChildren, getElementName, getParent, getPrototypeList, isClassDefinition, isWithinClassDefinition

Methods inherited from class ptolemy.kernel.util.NamedObj

_addAttribute, _adjustOverride, _attachText, _cloneFixAttributeFields, _copyChangeRequestList, _debug, _debug, _debug, _debug, _debug, _executeChangeRequests, _getIndentPrefix, _isMoMLSuppressed, _markContentsDerived, _notifyHierarchyListenersAfterChange, _notifyHierarchyListenersBeforeChange, _propagateValue, _removeAttribute, _splitName, _stripNumericSuffix, addChangeListener, addDebugListener, addHierarchyListener, attributeDeleted, attributeList, attributeList, attributeTypeChanged, clone, decorators, deepContains, depthInHierarchy, description, description, event, executeChangeRequests, exportMoML, exportMoML, exportMoML, exportMoML, exportMoMLPlain, getAttribute, getAttributes, getChangeListeners, getClassName, getDecoratorAttribute, getDecoratorAttributes, getDerivedLevel, getDerivedList, getDisplayName, getFullName, getModelErrorHandler, getName, getName, getSource, handleModelError, isDeferringChangeRequests, isOverridden, isPersistent, lazyContainedObjectsIterator, message, notifyOfNameChange, propagateValue, propagateValues, removeAttribute, removeChangeListener, removeDebugListener, removeHierarchyListener, requestChange, setClassName, setDeferringChangeRequests, setDerivedLevel, setDisplayName, setModelErrorHandler, setPersistent, setSource, sortContainedObjects, toplevel, toString, validateSettables, workspace

Methods inherited from class java.lang.Object

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

Methods inherited from interface ptolemy.kernel.util.Derivable

getDerivedLevel, getDerivedList, propagateValue

Methods inherited from interface ptolemy.kernel.util.Nameable

description, getDisplayName, getFullName, getName, getName

Constructor Detail

MatrixTokenTableau

public MatrixTokenTableau(Effigy container,
                          java.lang.String name)
                   throws IllegalActionException,
                          NameDuplicationException

Construct a new tableau for the model represented by the given effigy. Use setFrame() to specify the plot frame after construction.

Parameters:

container - The container.

name - The name.

Throws:

IllegalActionException - If the container does not accept this entity (this should not occur).

NameDuplicationException - If the name coincides with an attribute already in the container.

MatrixTokenTableau

public MatrixTokenTableau(Effigy container,
                          java.lang.String name,
                          TableauFrame frame)
                   throws IllegalActionException,
                          NameDuplicationException

Construct a new tableau for the model represented by the given effigy, using the specified frame.

Parameters:

container - The container.

name - The name.

frame - The frame to use.

Throws:

IllegalActionException - If the container does not accept this entity (this should not occur).

NameDuplicationException - If the name coincides with an attribute already in the container.

Method Detail

append

public void append(Token token)

Display the specified token. If the display is not a MatrixPane, or the token is not a MatrixToken, do nothing.

Overrides:

append in class TokenTableau

Parameters:

token - The token to append.

append

public void append(java.util.List list)

Display the specified tokens. If the display is not a MatrixPane, or the tokens are not instances of MatrixToken, do nothing.

Overrides:

append in class TokenTableau

Parameters:

list - A list of tokens.

canDisplay

public static boolean canDisplay(Token token)

Return true if this tableau can display the specified token.

Parameters:

token - A candidate token to display.

Returns:

True if the argument is a MatrixToken.

clear

public void clear()

Clear the display.

Overrides:

clear in class TokenTableau

createFrame

public void createFrame(TableauFrame frame)
                 throws IllegalActionException

Create a matrix frame to view the data. If the argument is null, then a new TableauFrame is created. This is called in the constructor.

Overrides:

createFrame in class TokenTableau

Parameters:

frame - The frame to use, or null if none is specified.

Throws:

IllegalActionException - If the frame cannot be created.

See Also:

MatrixPane