com.webobjects.eogeneration
Class EOActionController

java.lang.Object
  |
  +--com.webobjects.eoapplication.EOController
        |
        +--com.webobjects.eoapplication.EOComponentController
              |
              +--com.webobjects.eogeneration.EOWidgetController
                    |
                    +--com.webobjects.eogeneration.EOAssociationController
                          |
                          +--com.webobjects.eogeneration.EOTitlesController
                                |
                                +--com.webobjects.eogeneration.EOActionController

All Implemented Interfaces:

ComponentListener, EOAction.Enabling, EOAssociationConnector, EOComponentController.EndEditing, EOEditable, EventListener, NSDisposable, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions

public class EOActionController

extends EOTitlesController

implements ComponentListener

Nested Class Summary

Nested classes inherited from class com.webobjects.eogeneration.EOWidgetController

EOWidgetController.DefaultAction, EOWidgetController.FormatWidget, EOWidgetController.QueryWidget, EOWidgetController.TableWidget

Nested classes inherited from class com.webobjects.eoapplication.EOComponentController

EOComponentController.ActionCollector, EOComponentController.Activation, EOComponentController.EndEditing, EOComponentController.Modal, EOComponentController.ResetUserInterface

Nested classes inherited from class com.webobjects.eoapplication.EOController

EOController.Enumeration

Nested classes inherited from class com.webobjects.foundation.NSKeyValueCoding

NSKeyValueCoding.DefaultImplementation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.Null, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.Utility, NSKeyValueCoding.ValueAccessor

Nested classes inherited from class com.webobjects.foundation.NSKeyValueCodingAdditions

NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility

Field Summary

Fields inherited from class com.webobjects.eogeneration.EOTitlesController

NewTitlesDisplayGroupProviderMethodName

Fields inherited from class com.webobjects.eogeneration.EOAssociationController

ControllerDisplayGroupProviderMethodName

Fields inherited from class com.webobjects.eoapplication.EOComponentController

Bottom, BottomLeft, BottomRight, Center, Left, Right, Top, TopLeft, TopRight

Fields inherited from class com.webobjects.eoapplication.EOController

ControllerAndSubcontrollersEnumeration, ControllerAndSupercontrollersEnumeration, SubcontrollersEnumeration, SupercontrollersEnumeration

Fields inherited from interface com.webobjects.eoapplication.EOEditable

AlwaysEditable, IfSupercontrollerEditable, NeverEditable

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

KeyPathSeparator

Constructor Summary

EOActionController()

EOActionController(EOXMLUnarchiver unarchiver)

Method Summary

String	actionKey()
int	buttonPosition()
boolean	canBeTransient() Returns whether the controller can be transient.
protected void	componentDidBecomeVisible() Invoked when the receiver's component becomes visible, giving the receiver a chance to react.
void	componentHidden(ComponentEvent event)
void	componentMoved(ComponentEvent event)
void	componentResized(ComponentEvent event)
void	componentShown(ComponentEvent event)
protected void	connectionWasBroken() Invoked from breakConnection to notify the receiver that its connection to its supercontroller has been broken, giving the receiver the opportunity to clean up after its become idle.
protected void	connectionWasEstablished() Invoked from establishConnection to notify the receiver that its connection to the controller hierarchy has been established, giving the receiver the opportunity to prepare itself (for example, setting delegates).
protected NSArray	defaultActions() Returns an array of the receiver's default actions (EOAction objects).
protected void	disposeAssociations()
protected boolean	disposeIfTransient() Disposes the receiver if it's transient, first removing it from its supercontroller with removeTransientSubcontroller If the receiver's supercontroller is non-null, this method also attempts to dispose of the supercontroller if it's transient.
protected EOAssociation	newAssociation(JComponent widget, EODisplayGroup displayGroup, String enabledKey, EODisplayGroup enabledDisplayGroup)
EODataSource	newTitlesDataSource()
protected JComponent	newWidget()
protected int	preferredWidgetAutosizingMask()
void	setActionKey(String string)
void	setButtonPosition(int position)
void	setUsesAction(boolean flag)
void	setUsesButton(boolean flag)
protected void	startListeningToWidget()
protected void	stopListeningToWidget()
String	toString() Returns the receiver as a string that states the receiver's class name and type name, whether the receiver is connected, the number of subcontrollers, whether or not the receiver has been prepared, whether or not the receiver is visible, information about widget sizing and alignment behavior, and so on.
boolean	usesAction()
boolean	usesButton()

Methods inherited from class com.webobjects.eogeneration.EOTitlesController

addTitleKey, availableTitlesKey, endEditing, newTitlesDisplayGroup, prepareForNewTask, removeTitleKey, resetTitlesObjectsOnEveryConnect, searchesTitlesObjectsInEditingContext, setAvailableTitlesKey, setResetTitlesObjectsOnEveryConnect, setSearchesTitlesObjectsInEditingContext, setSingleTitleKey, setTitleKeys, setTitlesDisplayGroup, setTitlesDisplayGroupProviderMethodName, setTitlesEntityName, titleKeys, titlesDisplayGroup, titlesDisplayGroupProviderMethodName, titlesDisplayGroupSortOrderings, titlesEntityName

Methods inherited from class com.webobjects.eogeneration.EOAssociationController

association, controllerDisplayGroup, displayGroup, displayGroupProviderMethodName, dispose, editability, enabledDisplayGroup, enabledDisplayGroupProviderMethodName, enabledKey, isEditable, prefersContinuousChangeNotification, setAssociation, setDisplayGroup, setDisplayGroupProviderMethodName, setEditability, setEnabledDisplayGroup, setEnabledDisplayGroupProviderMethodName, setEnabledKey, setPrefersContinuousChangeNotification, setSuppressesAssociation, supercontrollerEditabilityDidChange, suppressesAssociation, takeResponsibilityForEditabilityOfAssociation, takeResposibilityForConnectionOfAssociation

Methods inherited from class com.webobjects.eogeneration.EOWidgetController

generateComponent, highlightsLabel, labelComponent, labelComponentAlignment, labelComponentPosition, labelComponentWidth, minimumWidgetSize, newLabelComponent, preferredLabelComponentPosition, preferredUsesLabelComponent, setAlignmentForWidget, setHighlightsLabel, setLabelComponent, setLabelComponentAlignment, setLabelComponentPosition, setLabelComponentWidth, setMinimumWidgetSize, setUsesLabelComponent, setWidget, setWidgetAlignment, toolTipComponent, usesLabelComponent, widget, widgetAlignment

Methods inherited from class com.webobjects.eoapplication.EOComponentController

activateFirstFocusComponent, addComponentOfSubcontroller, alignsComponents, canResizeHorizontally, canResizeVertically, component, componentDidBecomeInvisible, defaultComponentSize, ensureMinimumComponentSizeWithoutSubcontrollers, ensureMinimumSubcontrollerAreaSize, firstFocusComponent, handleTakeValueForUnboundKey, hideInSupercontroller, hideSubcontroller, icon, insets, integrationComponent, integrationComponentDidBecomeInvisible, integrationComponentDidBecomeVisible, isComponentPrepared, isRootComponentController, isVisible, label, lastFocusComponent, makeInvisible, makeVisible, minimumComponentSize, minimumComponentSizeWithoutSubcontrollers, minimumIntegrationComponentSize, minimumSubcontrollerAreaSize, prefersIconOnly, prepareComponent, removeComponentOfSubcontroller, removeTransientSubcontroller, setAlignsComponents, setCanResizeHorizontally, setCanResizeVertically, setComponent, setDefaultComponentSize, setFirstFocusComponent, setIcon, setInsets, setLabel, setLastFocusComponent, setPrefersIconOnly, setSubcontrollerArea, setToolTip, setUsesHorizontalLayout, setVisible, showInSupercontroller, showSubcontroller, subcontrollerArea, subcontrollerMinimumSizeDidChange, subcontrollerWasAdded, subcontrollerWasRemoved, toolTip, usesHorizontalLayout

Methods inherited from class com.webobjects.eoapplication.EOController

actionNames, actions, actionWithName, additionalActions, additionalKeyValuePairs, addSubcontroller, breakConnection, breakConnectionToSubcontrollers, canAccessFieldsDirectly, canPerformActionNamed, controllerEnumeration, controllersInEnumeration, controllersWithKeyValuePair, controllersWithKeyValuePairs, controllerWithKeyValuePair, controllerWithKeyValuePairs, disableActionNamed, disposableRegistry, enableActionNamed, enabledActions, establishConnection, establishConnectionToSupercontrollers, handleQueryWithUnboundKey, hierarchicalControllerForKey, hierarchicalValueForKey, invokeMethod, isActionNamedEnabled, isAncestorOfController, isConnected, isSupercontrollerOfController, isTransientExplicitlyForbidden, removeFromSupercontroller, removeSubcontroller, resetActions, setAdditionalActions, setAdditionalKeyValuePair, setAdditionalKeyValuePairs, setConnected, setSupercontroller, setTransientExplicitlyForbidden, setTypeName, subcontrollers, supercontroller, supercontroller, takeValueForKey, takeValueForKeyPath, typeName, unableToSetNullForKey, valueForKey, valueForKeyPath

Methods inherited from class java.lang.Object

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

Constructor Detail

EOActionController

public EOActionController()

EOActionController

public EOActionController(EOXMLUnarchiver unarchiver)

Method Detail

actionKey

public String actionKey()

buttonPosition

public int buttonPosition()

canBeTransient

public boolean canBeTransient()

Description copied from class: EOComponentController

Returns whether the controller can be transient. By default, a component controller is transient only if it's an instance of EOComponentController, not an instance of a subclass.

Overrides:

canBeTransient in class EOComponentController

Returns:

true if the receiver can be transient; false otherwise

componentDidBecomeVisible

protected void componentDidBecomeVisible()

Description copied from class: EOComponentController

Invoked when the receiver's component becomes visible, giving the receiver a chance to react. EOComponentController's implementation invokes establishConnection to ensure the receiver is connected to the controller hierarchy.

Overrides:

componentDidBecomeVisible in class EOComponentController

componentHidden

public void componentHidden(ComponentEvent event)

Specified by:

componentHidden in interface ComponentListener

componentMoved

public void componentMoved(ComponentEvent event)

Specified by:

componentMoved in interface ComponentListener

componentResized

public void componentResized(ComponentEvent event)

Specified by:

componentResized in interface ComponentListener

componentShown

public void componentShown(ComponentEvent event)

Specified by:

componentShown in interface ComponentListener

connectionWasBroken

protected void connectionWasBroken()

Description copied from class: EOController

Invoked from breakConnection to notify the receiver that its connection to its supercontroller has been broken, giving the receiver the opportunity to clean up after its become idle.

Overrides:

connectionWasBroken in class EOTitlesController

See Also:

EOController.breakConnection()

connectionWasEstablished

protected void connectionWasEstablished()

Description copied from class: EOController

Invoked from establishConnection to notify the receiver that its connection to the controller hierarchy has been established, giving the receiver the opportunity to prepare itself (for example, setting delegates).

Overrides:

connectionWasEstablished in class EOTitlesController

See Also:

EOController.establishConnection()

defaultActions

protected NSArray defaultActions()

Description copied from class: EOController

Returns an array of the receiver's default actions (EOAction objects). A subclass of EOController should override this method to return the actions it defines merged with the actions of its superclass. Never invoke this method directly. Instead, invoke actions, which caches the results of defaultActions and is therefore more efficient.

Overrides:

defaultActions in class EOController

Returns:

an array of the receiver's default actions

See Also:

EOController.actions(), EOController.resetActions()

disposeAssociations

protected void disposeAssociations()

Overrides:

disposeAssociations in class EOTitlesController

disposeIfTransient

protected boolean disposeIfTransient()

Description copied from class: EOController

Disposes the receiver if it's transient, first removing it from its supercontroller with removeTransientSubcontroller If the receiver's supercontroller is non-null, this method also attempts to dispose of the supercontroller if it's transient. Supercontrollers can prevent a controller from becoming transient, in which case this method returns false. Subclasses should first invoke the super implementation and only continue disposing if the super implementation returns true.

Overrides:

disposeIfTransient in class EOAssociationController

Returns:

true if the receiver can be transient and has been disposed; false otherwise

See Also:

EOController.removeTransientSubcontroller(EOController)

newAssociation

protected EOAssociation newAssociation(JComponent widget,
                                       EODisplayGroup displayGroup,
                                       String enabledKey,
                                       EODisplayGroup enabledDisplayGroup)

Overrides:

newAssociation in class EOTitlesController

newTitlesDataSource

public EODataSource newTitlesDataSource()

Overrides:

newTitlesDataSource in class EOTitlesController

newWidget

protected JComponent newWidget()

Specified by:

newWidget in class EOWidgetController

preferredWidgetAutosizingMask

protected int preferredWidgetAutosizingMask()

Overrides:

preferredWidgetAutosizingMask in class EOWidgetController

setActionKey

public void setActionKey(String string)

setButtonPosition

public void setButtonPosition(int position)

setUsesAction

public void setUsesAction(boolean flag)

setUsesButton

public void setUsesButton(boolean flag)

startListeningToWidget

protected void startListeningToWidget()

Overrides:

startListeningToWidget in class EOWidgetController

stopListeningToWidget

protected void stopListeningToWidget()

Overrides:

stopListeningToWidget in class EOWidgetController

toString

public String toString()

Description copied from class: EOComponentController

Returns the receiver as a string that states the receiver's class name and type name, whether the receiver is connected, the number of subcontrollers, whether or not the receiver has been prepared, whether or not the receiver is visible, information about widget sizing and alignment behavior, and so on.

Overrides:

toString in class EOTitlesController

Returns:

the String representation of the receiver

usesAction

public boolean usesAction()

usesButton

public boolean usesButton()