WebObjects 5.2

com.webobjects.eointerface.swing
Class EOControlActionAdapter

java.lang.Object
  |
  +--com.webobjects.eointerface.swing.EOControlActionAdapter
All Implemented Interfaces:
ActionListener, EventListener, NSDisposable

public class EOControlActionAdapter
extends Object
implements ActionListener, NSDisposable

The EOControlActionAdapter class is used to connect user interface widgets to the actions performed with those controls. They are usually generated automatically to represent connections made in Interface Builder. For example, suppose you create a connection from a "Fetch" button to a display group and that you connect the button to the display group's fetch method. At runtime, an EOControlActionAdapter object is used to invoke the display group's fetch method when a user clicks the Fetch button. In this example, the display group is the EOControlActionAdapter's target, "fetch" is the name of the action method to perform on the target, and the button is the listenee. An EOControlActionAdapter listens for the listenee (the button) to be acted upon (to be pushed). When the listenee is acted upon, the EOControlActionAdapter performs the action on its target (invokes the display group's fetch method).


Constructor Summary
EOControlActionAdapter(Object target, String actionName, Object listenee)
          Constructs a new EOControlActionAdapter that performs the method identified by actionName on the object target when the widget listenee is acted upon.
EOControlActionAdapter(String actionName, Object listenee)
          Constructs a new EOControlActionAdapter that performs the method identified by actionName when the widget listenee is acted upon.
 
Method Summary
 void actionPerformed(ActionEvent event)
          Invokes the action method on the target of the EOControlActionAdaptor.
 void dispose()
          Releases all resources used by this object and ensures that it becomes available for garbage collection.
 void setTarget(Object target)
          Sets the receiver's target to target.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

EOControlActionAdapter

public EOControlActionAdapter(Object target,
                              String actionName,
                              Object listenee)
Constructs a new EOControlActionAdapter that performs the method identified by actionName on the object target when the widget listenee is acted upon.
Parameters:
target - the action target
actionName - the name of the action method
listenee - listenee (widget) to be acted upon
Throws:
java.lang.illegalStateException - if listenee is null

EOControlActionAdapter

public EOControlActionAdapter(String actionName,
                              Object listenee)
Constructs a new EOControlActionAdapter that performs the method identified by actionName when the widget listenee is acted upon. Note that you have to set the target later if you want this action to have any effect.
Parameters:
actionName - the name of the action method
listenee - listenee (widget) to be acted upon
Throws:
java.lang.illegalStateException - if listenee is null
Method Detail

actionPerformed

public void actionPerformed(ActionEvent event)
Invokes the action method on the target of the EOControlActionAdaptor. Invoked when the listenee is acted upon.
Specified by:
actionPerformed in interface ActionListener
Parameters:
event - the user event triggering the action

dispose

public void dispose()
Releases all resources used by this object and ensures that it becomes available for garbage collection. Note that you should not use the object any further after invoking dispose.
Specified by:
dispose in interface NSDisposable

setTarget

public void setTarget(Object target)
Sets the receiver's target to target.
Parameters:
target - the action target

Last updated Fri Feb 21 13:15:00 PST 2003.

Copyright © 2003 Apple Computer, Inc.