com.sas.mdtable
Class AxisChangedEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.beans.PropertyChangeEvent
              |
              +--com.sas.collection.ContentsChangedEvent
                    |
                    +--com.sas.mdtable.AxisChangedEvent

All Implemented Interfaces:

public class AxisChangedEvent

extends ContentsChangedEvent

Defines a way for a multidimensional table model, StaticMultidimensionalTableInterface, to indicate that one of its axes has changed. AxisChangedEvent is a subclass of ContentsChangedEvent, so it can be sent to the standard list of ContentsChangedEvent listeners. Multidimensional views, such as MultidimensionalTableView, that are aware of AxisChangedEvent will be able to update themselves more efficiently by only rereading the dimensions of the single changed axis rather than having to reread all axes and their dimensions as required by a generic ContentsChangedEvent.

Sometimes a change along one axis can impact the other axes. The model can indicate this by specifying null for the constructor's axis parameter. Creating an AxisChangedEvent rather than a generic ContentsChangedEvent in such a case is still preferable due to the focus label. Through the focus label, the view can still determine which axis the change was initiated on and direct the user's attention there rather than being forced to reset to the beginning of the table as with the generic event.

See Also:

StaticMultidimensionalTableInterface, MultidimensionalTableView, Serialized Form

Field Summary

AxisInterface	axis The axis that has changed; can be null (see introduction).
AxisLabelInterface	focusLabel A label along the axis where post-change attention should be directed; can be null.

Fields inherited from class java.util.EventObject

source

Constructor Summary

AxisChangedEvent(Object source, AxisInterface axis, AxisLabelInterface focusLabel)
Constructor.

Methods inherited from class com.sas.collection.ContentsChangedEvent

clone

Methods inherited from class java.beans.PropertyChangeEvent

getNewValue, getOldValue, getPropagationId, getPropertyName, setPropagationId

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

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

Field Detail

axis

public final AxisInterface axis

The axis that has changed; can be null (see introduction).

focusLabel

public final AxisLabelInterface focusLabel

A label along the axis where post-change attention should be directed; can be null.

Constructor Detail

AxisChangedEvent

public AxisChangedEvent(Object source,
                        AxisInterface axis,
                        AxisLabelInterface focusLabel)

Constructor.

Parameters:

source - The object, usually an instance of com.sas.mdtable.StaticMultidimensionalTableInterface, whose axis has changed.

axis - The axis that has changed or null (see introduction).

focusLabel - The label where post-change attention should be directed, may be null. A model may specify the parent label of a set of sub-labels as a focusLabel after a drill-up operation, for example. This would allow a view to ensure that the parent label was scrolled into view.