WebObjects 5.2.3

com.webobjects.eointerface
Class EOActionWidgetAssociation

java.lang.Object
  extended bycom.webobjects.eocontrol.EODelayedObserver
      extended bycom.webobjects.eointerface.EOAssociation
          extended bycom.webobjects.eointerface.EOWidgetAssociation
              extended bycom.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 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

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

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.


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

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

subjectChanged

public void subjectChanged()
See the subjectChanged method description in the superclass EOAssociation.

Overrides:
subjectChanged in class EOAssociation

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

Last updated Thu Oct 21 15:04:16 PDT 2004.

Copyright © 2004 Apple Computer, Inc.