com.webobjects.eointerface
Class EOActionWidgetAssociation

java.lang.Object
  com.webobjects.eocontrol.EODelayedObserver
      com.webobjects.eointerface.EOAssociation
          com.webobjects.eointerface.EOWidgetAssociation
              com.webobjects.eointerface.EOActionWidgetAssociation

All Implemented Interfaces:

EOObserving, NSDisposable

Direct Known Subclasses:

EOActionAssociation, EOActionInsertionAssociation

public abstract class EOActionWidgetAssociation
extends EOWidgetAssociation

EOActionWidgetAssociation is an abstract superclass for associations that invoke methods on objects in response to an action in a user interface widget

Nested Class Summary

static class

EOActionWidgetAssociation.ActionPlugin ActionPlugin is an abstract superclass for plugins that provide a layer of abstraction between user interface widgets and EOActionWidgetAssociation subclasses.

Nested classes/interfaces inherited from class com.webobjects.eointerface.EOWidgetAssociation

EOWidgetAssociation.WidgetPlugin

Field Summary

Fields inherited from class com.webobjects.eointerface.EOAssociation

ActionAspect, ArgumentAspect, AttributeAspectSignature, AttributeToManyAspectSignature, AttributeToOneAspectSignature, AttributeToOneToManyAspectSignature, BackgroundColorAspect, BoldAspect, ChildrenAspect, DestinationAspect, EnabledAspect, ExpandedIconAspect, IconAspect, IgnoreValue, IsLeafAspect, ItalicAspect, MatchKey1Aspect, MatchKey2Aspect, MatchKey3Aspect, NullAspectSignature, ParentAspect, RootAspect, SelectedIndexAspect, SelectedObjectAspect, SelectedTitleAspect, SetValue, SourceAspect, TextColorAspect, TitlesAspect, ToManyAspectSignature, ToOneAspectSignature, ToOneToManyAspectSignature, UnsetValue, URLAspect, ValueAspect

Fields inherited from class com.webobjects.eocontrol.EODelayedObserver

ObserverNumberOfPriorities, ObserverPriorityFifth, ObserverPriorityFirst, ObserverPriorityFourth, ObserverPriorityImmediate, ObserverPriorityLater, ObserverPrioritySecond, ObserverPrioritySixth, ObserverPriorityThird

Constructor Summary

EOActionWidgetAssociation(Object aDisplayObject)
Subclasses should override this contructor to do any custom instance initialization and invoke super's implementation.

Method Summary

protected boolean	displayGroupSelectionsAllowEnabled() Evaluates whether the state of the association's display groups should allow the association to be enabled.
abstract void	invokeAction() Tells the action widget association to perform it's action.
protected boolean	isEnabled() If true, this association is enabled.
protected boolean	isEnabledAtIndex(int index) If true, this association is enabled for the object at index index in the display group's displayed objects array.
void	subjectChanged() See the subjectChanged method description in the superclass EOAssociation.
protected Class	widgetPluginClass() Specifies the widget plugin class this association can work wth.

Methods inherited from class com.webobjects.eointerface.EOWidgetAssociation

canSupportValueFormatter, defaultPrefersContinuousChangeNotification, dispose, isUsableWithObject, objectKeysTaken, prefersContinuousChangeNotification, setDefaultPrefersContinuousChangeNotification, setObject, setPrefersContinuousChangeNotification, setValueFormatter, valueFormatter, widgetPlugin

Methods inherited from class com.webobjects.eointerface.EOAssociation

aspects, aspectSignatures, associationClassesForObject, bindAspect, breakConnection, copyMatchingBindingsFromAssociation, displayGroupForAspect, displayGroupKeyForAspect, endEditing, establishConnection, isConnected, isExplicitlyDisabled, object, primaryAspect, priority, registerAssociationClass, setExplicitlyDisabled, setValueForAspect, setValueForAspectAtIndex, shouldEndEditing, shouldEndEditingAtIndex, valueForAspect, valueForAspectAtIndex

Methods inherited from class com.webobjects.eocontrol.EODelayedObserver

discardPendingNotification, objectWillChange, observerQueue

Methods inherited from class java.lang.Object

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

Constructor Detail

EOActionWidgetAssociation

public EOActionWidgetAssociation(Object aDisplayObject)

Subclasses should override this contructor to do any custom instance initialization and invoke super's implementation.

Parameters:

aDisplayObject - display object for this association to manage

Method Detail

widgetPluginClass

protected Class widgetPluginClass()

Specifies the widget plugin class this association can work wth. Subclasses should override this method to return the Class object for the plugin the association should be allowed to establish a connection to.

Overrides:

widgetPluginClass in class EOWidgetAssociation

Returns:

the Class EOActionWidgetAssociation.ActionPlugin

invokeAction

public abstract void invokeAction()

Tells the action widget association to perform it's action. Subclasses override this method to provide custom actions, such as EOActionInsertion's insertion action.

subjectChanged

public void subjectChanged()

See the subjectChanged method description in the superclass EOAssociation.

Overrides:

subjectChanged in class EOAssociation

displayGroupSelectionsAllowEnabled

protected boolean displayGroupSelectionsAllowEnabled()

Evaluates whether the state of the association's display groups should allow the association to be enabled. If false, calls to isEnabled for the association will return false. Subclasses can override this method to alter the behavior of isEnabled.

Returns:

the default implementation of this method simply returns true

isEnabledAtIndex

protected boolean isEnabledAtIndex(int index)

If true, this association is enabled for the object at index index in the display group's displayed objects array. If false, this association's invokeAction method has no effect.

Overrides:

isEnabledAtIndex in class EOAssociation

Parameters:

index - index of object in the association's EODisplayGroup bound to the enabled aspect

Returns:

false if super's isEnabledAtIndex method returns false or displayGroupSelectionsAllowEnabled returns false; true otherwise

isEnabled

protected boolean isEnabled()

If true, this association is enabled. If false, this association's invokeAction method has no effect.

Overrides:

isEnabled in class EOAssociation

Returns:

false if super.isEnabled() returns false or displayGroupSelectionsAllowEnabled returns false; true otherwise